Status

blueprint status is the terminal view of Blueprint and Git state. It reads the project without changing either one. The same optional global command also provides the separate live dashboard.

Run the global command

If you installed the optional global command, use:

blueprint status

The global command does not install or update Blueprint files. Those operations remain under npx create-ai-blueprint@latest.

Run through npx

You can run the same status implementation without a global installation:

npx create-ai-blueprint@latest status

Project discovery

Status searches upward from the current directory until it finds a Blueprint project. You can run it from the project root or a nested directory.

Use --target to inspect a different directory:

npx create-ai-blueprint@latest status --target /path/to/project
blueprint status --target /path/to/project

Running status outside a Blueprint project without a valid target exits with a clear error.

Human output

The default output groups information into Project, Progress, Git, Attention, and Next action sections. Interactive terminals receive restrained color. Piped output remains plain.

Status reports:

• Project configuration state and regular and Continuous quality-gate modes
• Build-plan completion and the next unchecked item
• Active feature, fix, or rollback progress
• Open findings and completion blockers
• Git branch, working-tree state, upstream distance, and latest commit
• Overview drift and malformed or placeholder plan warnings
• One deterministic next action

JSON output

Use --json for scripts and local integrations:

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

The command prints one versioned JSON object and does not include terminal color codes. Its configuration object includes the validated effective values, whether they came from the project file or built-in defaults, and any parsing warning.

Agent workflow status is different

$status in Codex, /status in Claude Code, and the status skill in GitHub Copilot or OpenCode are project-local agent skills. They ask an AI agent to interpret the project and recommend the next workflow action. The terminal blueprint status command is a deterministic local CLI report that does not require an agent conversation.

See Workflow Status for the agent skill.