CLI Reference

The Bootspring CLI provides 80 commands for managing your AI-assisted development workflow.

Installation#

Quick Reference#

One-Command Setup#

Build Loop (Daily Workflow)#

Setup (Step-by-Step)#

Development#

Hooks and Memory#

Observability#

Project Management#

Diagnostics#

Command Categories#

Build Commands#

The primary workflow for building your project with AI assistants:

• bootspring build next - Get next task and build
• bootspring build done - Mark complete, auto-queue next
• bootspring build status - View progress
• bootspring build skip - Skip current task
• bootspring build task - Show full details for the active task
• bootspring build pause / bootspring build resume - Safe pause and continuation
• bootspring build sync --replace - Rebuild runtime queue from planning/TODO.md
• bootspring build plan - View the full plan

Works with Claude Code, Cursor, Codex, and any AI coding assistant.

Go Command#

One-command setup from zero to building:

• bootspring go - Full workflow: detect + seed + generate + build init
• bootspring go "your pitch" - Seed from a project description

Seed Commands#

Commands for context creation and project setup (run before building):

• bootspring seed init - Create context document templates in .bootspring/context/
• bootspring seed merge - Merge context docs into SEED.md + auto-generate agent files + planning/
• bootspring seed go - Full end-to-end workflow
• bootspring seed status - Check what's ready
• bootspring seed from-codebase - Auto-detect stack from existing code

Initialization Commands#

• bootspring init - Initialize project (config + memory + stack detection)
• bootspring init --for <client> - Register MCP for a specific AI assistant

Hook Commands#

Commands for managing assistant hooks:

• bootspring hook install - Write hook config + init memory
• bootspring hook status - Show installed hooks
• bootspring hook doctor - Validate configs for drift
• bootspring hook smoke - Dry-run handlers locally
• bootspring hook uninstall - Remove hooks
• bootspring hook profile - Manage hook profile

Agent Commands#

Commands for working with expert agents:

• bootspring agent list - List available agents
• bootspring agent run <name> - Run a local agent
• bootspring agent show <name> - Get agent details
• bootspring agent invoke <name> - Invoke a hosted agent
• bootspring agent search <query> - Search agents

Memory Commands#

Commands for project memory:

• bootspring memory summary - Git-based learning summary
• bootspring memory search <query> - Search learnings by keyword
• bootspring memory recall <query> - Search cross-session memory
• bootspring memory save <note> - Save a decision/note
• bootspring memory stats - Repository statistics

Observe Commands#

Commands for session observability:

• bootspring observe status - Current session metrics
• bootspring observe costs - Cost tracking
• bootspring observe intelligence - Full analysis
• bootspring observe efficiency - Efficiency score
• bootspring observe on/off/quiet - Toggle modes

Session Commands#

Commands for session intelligence:

• bootspring session status - Current session status
• bootspring session list - List snapshots
• bootspring session health - Health check
• bootspring session clean - Remove old snapshots

Quality Commands#

Commands for code quality:

• bootspring quality pre-commit - Run pre-commit checks
• bootspring quality pre-push - Run pre-push checks
• bootspring quality full - Run all checks
• bootspring quality quick - Quick type check only
• bootspring quality analyze - Multi-agent quality analysis

Deploy Commands#

Commands for deployment:

• bootspring deploy validate - Pre-deployment checks
• bootspring deploy run - Execute deployment
• bootspring deploy status - Check deployment status
• bootspring deploy rollback - Rollback to previous

Swarm Commands#

Commands for multi-agent swarm intelligence:

• bootspring swarm status - Swarm status
• bootspring swarm topology - View agent topology
• bootspring swarm memory search - Query vector memory

Global Options#

These options work with most commands:

Environment Variables#

Exit Codes#

Getting Help#

Related#

• Getting Started - Quick start guide
• Configuration - Full config reference
• Troubleshooting - Common issues