CLI Reference
The Bootspring CLI provides powerful commands for managing your AI-assisted development workflow.
Installation#
Loading code block...
Quick Reference#
Build (Primary Command)#
| Command | Description |
|---|---|
bootspring build next | Start here - Get next task and build |
bootspring build done | Mark complete, auto-queue next |
bootspring build status | View build progress |
bootspring build skip | Skip current task |
bootspring build sync --replace | Replace runtime queue from planning/TASK_QUEUE.md |
bootspring build backfill | Recover missing preseed/SEED/TASK_QUEUE artifacts |
Setup#
| Command | Description |
|---|---|
bootspring preseed | Transform idea into foundational docs |
bootspring seed synthesize | Generate planning folder from preseed |
bootspring seed scaffold | Scaffold project structure |
bootspring init | Initialize Bootspring in your project |
Development#
| Command | Description |
|---|---|
bootspring agent <name> | Invoke an agent |
bootspring skill <name> | Apply a skill pattern |
bootspring quality <gate> | Run quality checks |
bootspring todo | Manage todos |
Workflows#
| Command | Description |
|---|---|
bootspring workflow start | Start a workflow |
bootspring workflow status | Check workflow status |
bootspring workflow list | List available workflows |
bootspring loop | Manage development loops |
Configuration#
| Command | Description |
|---|---|
bootspring config | Manage configuration |
bootspring plugin | Manage plugins |
bootspring auth | Manage authentication |
Dashboard#
| Command | Description |
|---|---|
bootspring dashboard | Start the dashboard |
bootspring dashboard --port | Start on custom port |
Command Categories#
Build Commands ⭐#
The primary workflow for building your MVP with AI assistants:
bootspring build next- Start building - queues next taskbootspring build done- Mark complete, auto-queue nextbootspring build status- View progressbootspring build skip- Skip current taskbootspring build task- Show full details for the active taskbootspring build stop/bootspring build resume- Safe pause and continuationbootspring build backfill- Recover build artifacts for existing/incomplete projectsbootspring build sync --replace- Rebuild runtime queue fromplanning/TASK_QUEUE.md
Works with Claude Code, Cursor, Codex, and any AI coding assistant.
Preseed Commands#
Commands for foundational documentation (run before building):
bootspring preseed init- Start the preseed wizardbootspring preseed status- Check preseed statusbootspring preseed update- Update config valuesbootspring preseed sync- Regenerate documentsbootspring preseed export- Export configuration
Initialization Commands#
Commands for setting up and configuring Bootspring:
bootspring init- Initialize a new projectbootspring generate- Generate context filesbootspring seed- Scaffold project structurebootspring config- Configure settings
Agent Commands#
Commands for working with expert agents:
bootspring agent list- List available agentsbootspring agent invoke- Invoke an agentbootspring agent info- Get agent details
Skill Commands#
Commands for using code patterns:
bootspring skill list- List available skillsbootspring skill show- Show skill contentbootspring skill search- Search for skillsbootspring skill apply- Apply a skill
Quality Commands#
Commands for code quality:
bootspring quality pre-commit- Run pre-commit checksbootspring quality pre-push- Run pre-push checksbootspring quality pre-deploy- Run pre-deploy checksbootspring quality full- Run all checks
Workflow Commands#
Commands for workflow management:
bootspring workflow start- Start a workflowbootspring workflow status- Check workflow statusbootspring workflow pause- Pause a workflowbootspring workflow resume- Resume a workflowbootspring workflow cancel- Cancel a workflowbootspring workflow list- List workflows
Todo Commands#
Commands for task management:
bootspring todo list- List todosbootspring todo add- Add a todobootspring todo done- Complete a todobootspring todo remove- Remove a todobootspring todo clear- Clear completed
Loop Commands#
Commands for development loops:
bootspring loop status- Check PRD statusbootspring loop next- Get next storybootspring loop complete- Complete a storybootspring loop create- Create a PRD
Dashboard Commands#
Commands for the dashboard:
bootspring dashboard- Start dashboardbootspring dashboard stop- Stop dashboardbootspring dashboard status- Check status
Global Options#
These options work with all commands:
| Option | Description |
|---|---|
--help, -h | Show help for command |
--version, -v | Show version number |
--verbose | Enable verbose output |
--quiet, -q | Suppress output |
--config <path> | Use custom config file |
--no-color | Disable colored output |
Environment Variables#
| Variable | Description |
|---|---|
BOOTSPRING_API_KEY | API key for authentication |
BOOTSPRING_CONFIG | Custom config file path |
BOOTSPRING_DEBUG | Enable debug mode |
BOOTSPRING_NO_TELEMETRY | Disable telemetry |
Configuration File#
The CLI reads from bootspring.config.js:
Loading code block...
Exit Codes#
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Invalid arguments |
| 3 | Configuration error |
| 4 | Authentication error |
| 5 | Quality check failed |
Getting Help#
Loading code block...
Examples#
Initialize a New Project#
Loading code block...
Daily Development Workflow#
Loading code block...
Working with Agents#
Loading code block...
Managing Tasks#
Loading code block...
Troubleshooting#
Command Not Found#
Loading code block...
Authentication Issues#
Loading code block...
Configuration Issues#
Loading code block...
Related#
- Getting Started - Quick start guide
- Configuration - Full config reference
- Troubleshooting - Common issues