CLI Commands

The aidimension CLI is a single binary that scaffolds, installs, and manages aidimension projects.

Install#

npm i -g @aidimension/cli
# or
pnpm add -g @aidimension/cli

Verify:

aidimension --version
# 0.4.1

Commands#

aidimension add <items...>#

Add components, templates, or skills to your project.

# Add specific components
aidimension add button card dialog

# Add a template
aidimension add template landing-page

# Add a skill
aidimension add skill aidimension-component

# Add all components
aidimension add --all

# Copy (paste) source into your project
aidimension add --copy button card

# Skip the install confirmation
aidimension add --yes button

Flags:

aidimension list#

List installed aidimension resources in the current project.

aidimension list                # human-readable
aidimension list --json         # machine-readable
aidimension list --filter ui    # only UI components

aidimension update#

Update installed resources to the latest version.

aidimension update              # interactive
aidimension update --all        # update everything
aidimension update --latest     # jump to latest, no questions
aidimension update button       # update a specific component

aidimension magic "<prompt>"#

Open the Magic AI builder. Generates a new page or component from a natural-language description.

aidimension magic "a pricing page with 3 tiers"
aidimension magic "a dark dashboard with stats and a chart"
aidimension magic --file spec.md

Requires OPENAI_API_KEY or ANTHROPIC_API_KEY in your environment.

aidimension theme <command>#

Manage your design tokens.

aidimension theme set primary "#7c3aed"
aidimension theme set radius 0.75rem
aidimension theme get primary
aidimension theme reset
aidimension theme export
aidimension theme import ./my-theme.json

aidimension init#

Scaffold a new aidimension project.

aidimension init my-app
aidimension init my-app --template dashboard
aidimension init . --typescript --tailwind

aidimension doctor#

Diagnose problems with your aidimension install.

aidimension doctor
# ✔ Node 22.0.0 (>= 20 required)
# ✔ pnpm 9.0.0 (>= 9 required)
# ✔ @aidimension/ui 0.4.1 (latest)
# ✖ Tailwind v4 not detected in postcss.config
# ✖ globals.css missing @import "tailwindcss"

aidimension skills <command>#

Manage AI agent skills.

aidimension skills list
aidimension skills install aidimension-component
aidimension skills install --all
aidimension skills update
aidimension skills remove aidimension-component

aidimension mcp <command>#

Configure the MCP server for your agent.

aidimension mcp init claude-desktop
aidimension mcp init cursor
aidimension mcp list-tools
aidimension mcp serve --port 7766

Global flags#

Environment variables#

Configuration#

Create aidimension.config.json in your project root to set defaults:

{
  "registry": "https://registry.aidimension.io",
  "componentsDir": "src/components/ui",
  "templatesDir": "src/app/(templates)",
  "theme": "default",
  "prettier": true,
  "git": {
    "commit": true,
    "message": "chore(ui): add {name}"
  }
}

Exit codes#