CLI Reference
CLI overview
Every intent command, grouped by workflow, with links to the detailed reference for each group.
Command index
All commands are subcommands of intent (package intentdocs). Flags shown are exact — this reference is generated by reading packages/cli/src/index.ts and the individual command source directly, not by hand-guessing.
| Command | Description |
|---|
intent login | Log in (opens browser) |
intent logout | Log out |
intent keys set [key] | Save your Anthropic API key |
intent keys status | Show whether a key is set (masked) |
intent keys remove | Remove your stored key |
| Command | Description |
|---|
intent start | Start a new project — guided flow from problem to pitch |
intent scope [projectId] | Scope a project — generate blueprint, story map, and mockup |
intent templates [name] | Browse story map templates |
intent init [token] | Connect this project to an intentdocs story map |
intent sync [--context] | Refresh INTENT.md, or regenerate the CLAUDE.md context file |
intent setup | Configure Claude Code / Cursor with intentdocs agent workflows |
| Command | Description |
|---|
intent status | Show story map progress |
intent stories [-f/-s/-k] | List all stories |
intent next [-o/--skip-wip/--story-id] | Show the next highest-priority story to work on |
intent implement <id> [--stub] | Pick up a story and mark it in-progress |
intent check [idPrefix] [--report] | Run executable acceptance criteria locally |
intent show <id> | Show the full spec for a story |
intent done <id> [--screenshot] | Mark a story as done |
intent stop <id> | Stop development of an in-progress story |
intent add <title> [-a/-p/-e] | Create a new story |
| Command | Description |
|---|
intent decide [title] [-d/-c/-s] | Log an architectural or product decision |
intent note <storyId> [note] | Add implementation notes to a story |
intent example | Add a few-shot reference pattern to the project |
| Command | Description |
|---|
intent complexity [storyId] | Analyze story complexity with AI |
intent research [query] | Research a topic with AI using your project context |
intent import [file] | Import a PRD or spec into your story map |
| Command | Description |
|---|
intent propose [name] [--from] | Propose a new change — creates stories + a local spec |
intent map extract | Print a prompt for your agent to extract a story map from an existing codebase |
intent map import <file> [--yes] | Import a storymap.json generated by your agent |
intent map schema | Print the JSON Schema for storymap.json |
| Command | Description |
|---|
intent mcp [-m/--mode] | Start the MCP server for Claude Code / Cursor |
intent openclaw-register | Register this project with OpenClaw MCP |
Where things get stored
- Sync config:
.intent/config.json, written in your project directory — contains the sync token, API base, and project/map IDs. Auto-gitignored.
- Auth token:
~/.intent/auth.json, in your home directory — one login per machine, shared across all projects.
- Per-story context:
.intent/stories/<storyId>.md — written by next, implement, and show; refreshed (not overwritten) by sync.
ID prefixes
Most commands that take a story <id> accept a prefix of the full ID rather than the whole UUID — intent show a1b2 matches the first story whose ID starts with a1b2.