@prototyperco/cli

CLI for Prototyper UI -- adds components, design tokens, utilities, AI tooling, and a full-screen terminal app to your project.

Requires Bun 1.1 or newer.

Quick start

bunx @prototyperco/cli init
bunx @prototyperco/cli add button

After init, run without a subcommand to open the terminal app:

bunx @prototyperco/cli

Jump directly to the component browser:

bunx @prototyperco/cli browse

The terminal app uses OpenTUI when running under Bun in a real TTY with colors enabled. It falls back to a Clack picker or plain output in CI, piped output, TERM=dumb, or when NO_COLOR is set.

Terminal controls

| Key | Action | | -------- | --------------------------- | | 1 | Home | | 2 | Browse | | 3 | Health | | 4 | Theme | | 5 | Compose | | 6 | Create | | 7 | Settings | | Ctrl+K | Command palette | | Tab | Switch tabs in detail views | | Esc | Close overlays or go back | | q | Quit |

Commands

| Command | Purpose | | ---------------- | --------------------------------------------------------- | | setup | Set up AI tooling in one step | | create | Create a new project with Prototyper UI pre-configured | | init | Add tokens, utilities, base styles, and prototyper.json | | add | Add components or integrations | | browse | Open the interactive component catalog | | update | Update installed components | | diff | Compare local components with the registry | | doctor | Check project health and configuration | | inspect | Inspect a component's exports, variants, props, and deps | | suggest | Scan code and suggest Prototyper UI replacements | | props | Print quick prop, variant, event, and export references | | export:context | Generate an AI context file for the current project | | audit | Verify Prototyper UI imports are installed | | scaffold | Scaffold a page from a template | | theme | Export and customize design tokens | | mcp | Run or configure the MCP server | | bridge | Start the Live Canvas bridge server | | skills | Manage AI skills for Claude Code and Cursor | | registry | Manage, create, and publish component registries | | search | Search components across registries | | migrate | Transform installed components | | machine-mode | Set up installable machine mode routes and runtime |

Local development

Build the registry and CLI packages before testing the local dist entry:

pnpm install
pnpm registry:build
pnpm --filter @prototyperco/bridge-client build
pnpm --filter @prototyperco/bridge build
pnpm --filter @prototyperco/cli build
pnpm --filter @prototyperco/cli typecheck
pnpm --filter @prototyperco/cli test

Launch the built CLI locally:

unset NO_COLOR
TERM=xterm-256color bun packages/cli/dist/index.js browse

Documentation

Full documentation at prototyper-ui.com/docs.

License

MIT