CLI Reference · 4.6

AI features

Score story complexity, research a question with your project context, and turn a PRD into stories.

These commands send your project's context to the AI on the server. They need a connected checkout, and a plan that includes AI features or an Anthropic key saved with intentdocs keys set.

Note: The plan and the key that count are the story map owner's, not yours. A teammate's saved key is not used on a map someone else owns.

When the server refuses on plan grounds, the command prints:

  This feature requires a Pro plan or your own Anthropic key.
    Upgrade: https://intentdocs.com/pricing
    Or add your key: npx intentdocs keys set

Note: The CLI prints this message for any 402 or 403 response. If you already have a plan or a key, check that your token can reach the project with intentdocs projects.

`intentdocs complexity`

Scores how complex your stories are, with risks and a suggested effort.

intentdocs complexity [storyId]

Argument	Meaning
`storyId`	One story's key, ID or ID prefix. Optional; without it, every story that is not done is scored.

intentdocs complexity
intentdocs complexity PB-42

For each story it prints a score out of 10 with a bar, the reasoning, any risks, and a suggested effort. Stories are sorted from most to least complex. A summary follows: the average score, how many stories scored 7 or more, and how many were scored.

The command reports only. It does not change any story's effort.

`intentdocs research`

Researches a question using your project's context and prints the answer as Markdown.

intentdocs research [query]

Argument	Meaning
`query`	Your question. Optional; the CLI prompts for it when you leave it out. Quote it if it has spaces.

intentdocs research "Should password reset links be single-use or time-limited for this app?"

The answer prints when it is complete, after the query line.

`intentdocs import`

Turns a PRD or spec into activities, steps and stories with acceptance criteria, then adds them to your story map once you confirm.

intentdocs import [file] [--yes]

Argument	Meaning
`file`	The document to import. A `.md` file is sent as Markdown and a `.txt` file as plain text; anything else is sent as a PRD. Leave it out to read the document from standard input.

Option	Default	Meaning
`-y, --yes`	off	Import without asking. Required when the document comes from standard input.

intentdocs import docs/prd.md
cat docs/prd.md | intentdocs import --yes

The CLI prints the parsed structure first: each activity, its steps, and each story's priority, title, effort and acceptance criteria. Nothing is added to your map until you answer y to Import this story map structure?. It then prints how many activities, steps and stories it created.

Behaviour to know:

The server parses only the first 24,000 characters of the document.
Without a saved key, imports count toward the plan's monthly generation limit. When it is reached, the import fails with the server's message. With a key, there is no monthly cap.
Without file, the CLI reads the document from standard input until end of input (Ctrl+D when you paste it at a terminal). That leaves nothing to answer the confirmation with, so standard input needs --yes: the parsed structure is printed and imported without asking. Without --yes, the command reads nothing, says how to run it, and exits 1. To review the structure before anything is added, pass a file path.