CLI Overview

What the global command does

blueprint has two read-only project views:

blueprint status
blueprint status --json
blueprint status --target ./my-app
blueprint dashboard
blueprint dashboard --no-open

Status prints a deterministic terminal report. Dashboard opens a live local browser view for the same Blueprint and Git state. Neither operation changes project files. The older blueprint ui form remains as a deprecated alias. Run blueprint --help for the complete options or blueprint --version for the installed version.

The global command is optional. Both views also work through npx:

npx create-ai-blueprint@latest status
npx create-ai-blueprint@latest dashboard

Install the optional command

An interactive Blueprint installation or update checks the installed global CLI version. It asks only when the command is missing or does not match the npx package version, and explains that npx remains available. The prompt defaults to no. You can also install or refresh it directly:

npm install --global create-ai-blueprint@latest

This is a system-level npm installation, not a dependency inside your app. Matching versions continue without a prompt.

Read next

• CLI Status covers human and JSON project status.
• Live Dashboard covers the browser view and its local-only boundary.
• Getting Started covers installing Blueprint files.
• Updating Blueprint covers safe managed-file updates.

Help for a specific command

blueprint status --help
blueprint dashboard --help
npx create-ai-blueprint@latest update --help

These print focused options and examples without reading a project or installing files. blueprint update --help explains the installer command to use instead.

Workflow skills run in AI chat. Typing blueprint doctor in a terminal produces a hint to use $doctor in Codex or /doctor in Claude Code; it does not execute the skill. Retired command names point to their replacement modes.

Use your project’s package manager

The npx examples use npm. In pnpm projects, use pnpm dlx instead:

pnpm dlx create-ai-blueprint@latest status
pnpm dlx create-ai-blueprint@latest dashboard
pnpm dlx create-ai-blueprint@latest update

This avoids npm’s EBADDEVENGINES failure when a project requires pnpm. If @latest resolves an older release, follow the version-pinning guidance.