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.