Commands

Complete reference for all Brainstorm CLI commands.

Commands

Brainstorm provides a rich set of CLI commands accessible via storm . The default command is chat, which launches the interactive TUI.

Core Commands

chat

Launch the interactive terminal UI. This is the default when you run storm with no arguments.

``bash


storm chat
storm  # equivalent


run
Execute a single prompt non-interactively. Useful for scripts, CI pipelines, and automation.

`bash


storm run "Refactor the auth module to use JWT"
storm run --unattended "Fix all TypeScript errors"  # no confirmation prompts
storm run --pipe < prompt.txt                        # read prompt from stdin
storm run --json "List all API endpoints"            # output as JSON

The --unattended flag allows Brainstorm to execute tool calls without asking for permission, making it suitable for CI environments. Combine with --json for machine-readable output.


models
List all available models across configured providers, with routing scores and capability ratings.

`bash


storm models              # interactive model browser
storm models --list       # plain text list
storm models --provider anthropic  # filter by provider


config
Display the active configuration after all layers are merged (defaults, global, project, environment).

`bash


storm config              # show merged config
storm config --edit       # open config in $EDITOR
storm config --reset      # restore defaults


budget
View cost tracking data, forecasts, and spending limits.

`bash


storm budget              # current session and monthly totals
storm budget --forecast   # projected spend based on usage patterns
storm budget --export     # export cost records as CSV


Analysis Commands
analyze
Run codebase analysis to understand project structure, dependencies, and complexity metrics.

`bash


storm analyze             # full analysis
storm analyze --languages # language breakdown only


docgen
Generate documentation from your codebase.

`bash


storm docgen              # generate docs for the project
storm docgen --format mdx # output format


ingest
Analyze and onboard a new codebase. Generates BRAINSTORM.md, agent configuration, and recipes.

`bash


storm ingest              # full three-phase ingest
storm ingest --analyze    # analysis phase only


search
Semantic code search using TF-IDF indexing across your project.

`bash


storm search "authentication middleware"
storm search --reindex  # rebuild the search index


Operational Commands
audit
View the audit log of all tool executions, model calls, and cost events.

`bash


storm audit               # recent audit entries
storm audit --session     # current session only
storm audit --export cef  # export in CEF format


spawn
Launch a subagent for a specific task with its own context and tool permissions.

`bash


storm spawn explore "Map the database schema"
storm spawn code "Implement the user settings page"


queue
Manage the async task queue for background work.

`bash


storm queue list          # show pending tasks
storm queue add "Write tests for auth module"
storm queue process       # process next task


setup-infra
Configure infrastructure integrations (Docker, CI/CD, deployment targets).

`bash


storm setup-infra


share
Export a session transcript for sharing.

`bash


storm share               # copy shareable link
storm share --markdown    # export as markdown


ci-gen
Generate CI/CD pipeline configuration for your project.

`bash


storm ci-gen              # auto-detect and generate
storm ci-gen --target github-actions
storm ci-gen --target vercel