CLI Reference

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

Installation#

Loading code block...

Quick Reference#

Build (Primary Command)#

CommandDescription
bootspring build nextStart here - Get next task and build
bootspring build doneMark complete, auto-queue next
bootspring build statusView build progress
bootspring build skipSkip current task
bootspring build sync --replaceReplace runtime queue from planning/TASK_QUEUE.md
bootspring build backfillRecover missing preseed/SEED/TASK_QUEUE artifacts

Setup#

CommandDescription
bootspring preseedTransform idea into foundational docs
bootspring seed synthesizeGenerate planning folder from preseed
bootspring seed scaffoldScaffold project structure
bootspring initInitialize Bootspring in your project

Development#

CommandDescription
bootspring agent <name>Invoke an agent
bootspring skill <name>Apply a skill pattern
bootspring quality <gate>Run quality checks
bootspring todoManage todos

Workflows#

CommandDescription
bootspring workflow startStart a workflow
bootspring workflow statusCheck workflow status
bootspring workflow listList available workflows
bootspring loopManage development loops

Configuration#

CommandDescription
bootspring configManage configuration
bootspring pluginManage plugins
bootspring authManage authentication

Dashboard#

CommandDescription
bootspring dashboardStart the dashboard
bootspring dashboard --portStart on custom port

Command Categories#

Build Commands#

The primary workflow for building your MVP with AI assistants:

  • bootspring build next - Start building - queues next task
  • 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 stop / bootspring build resume - Safe pause and continuation
  • bootspring build backfill - Recover build artifacts for existing/incomplete projects
  • bootspring build sync --replace - Rebuild runtime queue from planning/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 wizard
  • bootspring preseed status - Check preseed status
  • bootspring preseed update - Update config values
  • bootspring preseed sync - Regenerate documents
  • bootspring preseed export - Export configuration

Initialization Commands#

Commands for setting up and configuring Bootspring:

  • bootspring init - Initialize a new project
  • bootspring generate - Generate context files
  • bootspring seed - Scaffold project structure
  • bootspring config - Configure settings

Agent Commands#

Commands for working with expert agents:

  • bootspring agent list - List available agents
  • bootspring agent invoke - Invoke an agent
  • bootspring agent info - Get agent details

Skill Commands#

Commands for using code patterns:

  • bootspring skill list - List available skills
  • bootspring skill show - Show skill content
  • bootspring skill search - Search for skills
  • bootspring skill apply - Apply a skill

Quality Commands#

Commands for code quality:

  • bootspring quality pre-commit - Run pre-commit checks
  • bootspring quality pre-push - Run pre-push checks
  • bootspring quality pre-deploy - Run pre-deploy checks
  • bootspring quality full - Run all checks

Workflow Commands#

Commands for workflow management:

  • bootspring workflow start - Start a workflow
  • bootspring workflow status - Check workflow status
  • bootspring workflow pause - Pause a workflow
  • bootspring workflow resume - Resume a workflow
  • bootspring workflow cancel - Cancel a workflow
  • bootspring workflow list - List workflows

Todo Commands#

Commands for task management:

  • bootspring todo list - List todos
  • bootspring todo add - Add a todo
  • bootspring todo done - Complete a todo
  • bootspring todo remove - Remove a todo
  • bootspring todo clear - Clear completed

Loop Commands#

Commands for development loops:

  • bootspring loop status - Check PRD status
  • bootspring loop next - Get next story
  • bootspring loop complete - Complete a story
  • bootspring loop create - Create a PRD

Dashboard Commands#

Commands for the dashboard:

  • bootspring dashboard - Start dashboard
  • bootspring dashboard stop - Stop dashboard
  • bootspring dashboard status - Check status

Global Options#

These options work with all commands:

OptionDescription
--help, -hShow help for command
--version, -vShow version number
--verboseEnable verbose output
--quiet, -qSuppress output
--config <path>Use custom config file
--no-colorDisable colored output

Environment Variables#

VariableDescription
BOOTSPRING_API_KEYAPI key for authentication
BOOTSPRING_CONFIGCustom config file path
BOOTSPRING_DEBUGEnable debug mode
BOOTSPRING_NO_TELEMETRYDisable telemetry

Configuration File#

The CLI reads from bootspring.config.js:

Loading code block...

Exit Codes#

CodeMeaning
0Success
1General error
2Invalid arguments
3Configuration error
4Authentication error
5Quality 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...