CLI Essentials | Bootspring Docs

The Bootspring CLI is your primary interface for local development. This guide covers the essential commands you'll use every day.

Installation#

Loading code block...

Verify installation:

Loading code block...

Core Commands#

Initialize a Project#

Loading code block...

This creates:

bootspring.config.js - Configuration file
.mcp.json - MCP server setup
CLAUDE.md - AI context file

Options:

Loading code block...

Generate Context#

Regenerate the CLAUDE.md context file:

Loading code block...

Options:

Loading code block...

Check Setup#

Diagnose and fix common issues:

Loading code block...

Output:

Bootspring Doctor
═════════════════

✓ Node.js version: 20.10.0
✓ npm version: 10.2.3
✓ bootspring.config.js found
✓ .mcp.json configured
✓ CLAUDE.md generated
✓ MCP server reachable

All checks passed!

Build Loop Essentials#

For task-queue driven implementation:

Loading code block...

Queue synchronization and recovery:

Loading code block...

If running from a local source checkout and new subcommands do not appear:

Loading code block...

Agent Commands#

List Agents#

Loading code block...

Output:

Technical Agents
────────────────
frontend-expert     React, Next.js, Vue, CSS, accessibility
backend-expert      Node.js, APIs, server architecture
database-expert     SQL, Prisma, MongoDB, schema design
...

Business Agents (Pro)
─────────────────────
growth-expert       PLG, retention, metrics
fundraising-expert  Pitch decks, investor outreach
...

Filter by category:

Loading code block...

Search Agents#

Loading code block...

Output:

Matching Agents
───────────────
auth-expert         JWT, Auth.js, Auth0, sessions
security-expert     OWASP, auth, encryption, auditing
backend-expert      Node.js, APIs, server architecture

Invoke an Agent#

Loading code block...

This opens an interactive session with the agent. Or use with the MCP server through your AI assistant.

Skill Commands#

List Skills#

Loading code block...

Output:

Authentication (auth/)
──────────────────────
jwt             First-party JWT session auth
nextauth        NextAuth.js configuration
oauth           OAuth provider integration
session         Session management with JWT
...

Database (database/)
────────────────────
prisma-crud     Prisma CRUD operations
queries         Optimized query patterns
...

Filter by category:

Loading code block...

Search Skills#

Loading code block...

Output:

Matching Skills
───────────────
payments/stripe         Stripe setup
payments/checkout       Checkout flow
payments/subscriptions  Recurring billing
payments/webhooks       Webhook handling

Show a Skill#

Loading code block...

Displays the full skill content with code examples.

Workflow Commands#

List Workflows#

Loading code block...

Output:

Development Workflows
─────────────────────
feature-development    End-to-end feature building
database-migration     Safe database migrations
security-audit         Comprehensive security review

Launch Pack (Pro)
─────────────────
launch/pre-launch      Pre-launch checklist
launch/landing-page    High-converting landing page
...

Start a Workflow#

Loading code block...

Check Workflow Status#

Loading code block...

Output:

Active Workflows
────────────────

ID: feat-dev-abc123
Name: feature-development
Status: Running
Phase: 3/5 (Implementation)
Started: 5 minutes ago

Resume/Pause Workflows#

Loading code block...

Quality Commands#

Run Quality Gates#

Loading code block...

Output:

Quality Gate: pre-commit
════════════════════════

✓ TypeScript: No errors
✓ ESLint: 0 errors, 2 warnings
✓ Security: No vulnerabilities
✓ Format: All files formatted

Result: PASSED

Check Specific Files#

Loading code block...

Context Commands#

View Context#

Loading code block...

Search Context#

Loading code block...

Dashboard Commands#

Start Local Dashboard#

Loading code block...

Opens a local dashboard at http://localhost:3333 with:

Project status
Agent activity
Workflow progress
Quality results

Dashboard Options#

Loading code block...

Authentication Commands#

Bootspring uses browser-based device flow authentication. Each directory is linked to a specific project.

Loading code block...

Opens your browser to:

Authenticate with your account
Select or create a project
Link the current directory to that project

A .bootspring.json file is created in the current directory.

Check Auth Status#

Loading code block...

Output:

Authenticated as: user@example.com
Tier: Pro
Devices: 2/5 used
Project: my-app (from .bootspring.json)

Switch Projects#

Loading code block...

Logout#

Loading code block...

Clears global credentials from ~/.bootspring/. Does not remove local .bootspring.json files.

Configuration Commands#

Validate Config#

Loading code block...

Show Effective Config#

Loading code block...

Reset Config#

Loading code block...

Update Command#

Check for Updates#

Loading code block...

Update Bootspring#

Loading code block...

Common Workflows#

Starting a New Project#

Loading code block...

Daily Development#

Loading code block...

Starting a Workflow#

Loading code block...

Command Reference#

Command	Description
`bootspring init`	Initialize project
`bootspring generate`	Generate CLAUDE.md
`bootspring doctor`	Check setup
`bootspring agent list`	List agents
`bootspring agent invoke <name>`	Invoke agent
`bootspring skill list`	List skills
`bootspring skill show <name>`	Show skill
`bootspring workflow list`	List workflows
`bootspring workflow start <name>`	Start workflow
`bootspring workflow status`	Check status
`bootspring quality <gate>`	Run quality gate
`bootspring context show`	Show context
`bootspring dashboard`	Start dashboard
`bootspring auth login`	Authenticate
`bootspring auth status`	Check auth
`bootspring config show`	Show config
`bootspring update`	Update CLI