# AI agents

URL: https://developers.uidu.org/docs/tools/ai-agents

> Set up Claude Code, Cursor, Codex or any coding agent to build on uidu — skills, the Claude Code plugin, Markdown docs and a CLI that speaks JSON.

Everything here is built to be read and driven by coding agents as well as people. Pick what your agent supports.

## Give it the docs

| URL                                        | What it is                                                                            |
| ------------------------------------------ | ------------------------------------------------------------------------------------- |
| [`/llms.txt`](/llms.txt)                   | An index of every page, with a one-line description each.                             |
| [`/llms-full.txt`](/llms-full.txt)         | The whole documentation in one Markdown file.                                         |
| `/docs/<page>.md`                          | Any page as Markdown — e.g. [`/docs/domains/cms.md`](https://developers.uidu.org/docs/domains/cms.md.md).           |
| [`/sdk-manifest.json`](/sdk-manifest.json) | Every export of the SDK with its domain, read/write, auth, signature and CLI command. |
| `/mcp`                                     | A remote MCP server over these docs — see [Docs MCP server](https://developers.uidu.org/docs/tools/docs-mcp.md).    |

Every page also has buttons under its title to copy its Markdown or open it in Claude or ChatGPT. A prompt that works well:

```text
Build a uidu-powered Next.js site. Read https://developers.uidu.org/llms.txt first,
then scaffold with `npm create uidu-app@latest`.
```

## Install the skills

Skills teach an agent uidu's canonical patterns: which package to use, how to fetch and render each domain, how to scaffold and provision. Install them with [skills.sh](https://skills.sh):

```bash
npx skills add uidu-org/api.js --skill uidu -a claude-code
```

Replace `claude-code` with your agent (`cursor`, `copilot`, `windsurf`, …).

| Skill         | For                                                                                                 |
| ------------- | --------------------------------------------------------------------------------------------------- |
| `uidu`        | The SDK: package map, env setup, fetching and rendering every domain, the CLI, scaffolding.         |
| `uidu-design` | How an app framed inside uidu should look: tokens, components, layout in the iframe, states, icons. |

## Claude Code plugin

The plugin bundles the `uidu` skill with a `/uidu-new-app` command that goes from login to a scaffolded, wired and provisioned app:

```text
/plugin marketplace add uidu-org/api.js
/plugin install uidu@uidu-org
```

## Let it drive the CLI

The [`uidu` CLI](https://developers.uidu.org/docs/tools/cli.md) is the agent's hands: every command takes `--json`, and `uidu login --password-grant` works without a browser for CI and headless agents.

```bash
uidu whoami --json
uidu events list --json
uidu events create --name "Spring gala" --json
```

<Callout type="warn" title="Keep write tokens out of the browser">
  Writes authenticate as your account with a Bearer token. Let the agent use it from the CLI or server-side code only — never in a client component.
</Callout>
