aidimension UI CLI

# aidimension UI — CLI

The `aidimension-ui` CLI is a standalone npm package (`aidimension-ui`) with **zero
runtime dependencies**. It works on Node 18.17+.

## Commands

### `npx aidimension-ui init [name]`
Scaffold aidimension UI into a new project.

Creates:
- `src/lib/utils.ts` (the `cn()` helper)
- `src/lib/theme-provider.tsx` (with `useTheme()`)
- `src/app/globals.css` (design tokens, light + dark)
- `README.md` (setup instructions)

### `npx aidimension-ui add <name> [...]`
Copy one or more components from the registry into your project.
- Fetches source from the aidimension UI GitHub repo
- Writes to the canonical path (e.g. `src/components/ui/button.tsx`)
- Auto-installs peer deps via `pnpm add` / `npm install` / `yarn add`
- Prints the import statement

### `npx aidimension-ui list [filter]`
List all 76 registry entries, grouped by category.
- `npx aidimension-ui list` — all
- `npx aidimension-ui list motion` — only motion entries
- `npx aidimension-ui list chat` — fuzzy filter

### `npx aidimension-ui info <name>`
Show details for a single entry: description, dependencies, install
path, import statement, and a "next" hint.

### `npx aidimension-ui mcp`
Start the `@aidimension-ui/mcp` server over stdio. Use it in Claude Desktop,
Cursor, Continue, or any MCP-compatible client.

## Environment variables

| Variable          | Default                              | Purpose                                    |
| ----------------- | ------------------------------------ | ------------------------------------------ |
| `JSN_UI_REGISTRY` | `https://aidimension-ui.vercel.app/registry.json` | Override the registry endpoint URL.    |
| `JSN_UI_REPO_RAW` | `https://raw.githubusercontent.com/javashn/aidimension-ui/main` | Override the source-code fetch URL. |

## Output conventions

The CLI uses ANSI color when stdout is a TTY, and disables color when
piped (or when `NO_COLOR` is set).

## When the user asks to add a component

Always check `npx aidimension-ui list` (or fetch `https://aidimension-ui.vercel.app/registry.json`)
to confirm the exact slug before suggesting. Names use kebab-case.