Bootspring
HomeGet Started

CLI Essentials

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

Installation#

# Global install (recommended) npm install -g bootspring # Or use with npx npx bootspring <command>

Verify installation:

bootspring --version # bootspring v2.1.0

Core Commands#

Initialize a Project#

bootspring init

This creates:

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

Options:

1# Interactive setup 2bootspring init 3 4# Use a preset 5bootspring init --preset nextjs 6 7# Skip prompts with defaults 8bootspring init --yes 9 10# Specify project name 11bootspring init --name my-awesome-app

Generate Context#

Regenerate the CLAUDE.md context file:

bootspring generate

Options:

1# Force regeneration 2bootspring generate --force 3 4# Include specific sections 5bootspring generate --sections stack,structure,commands 6 7# Verbose output 8bootspring generate --verbose

Check Setup#

Diagnose and fix common issues:

bootspring doctor

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!

Agent Commands#

List Agents#

bootspring agent list

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:

bootspring agent list --category technical bootspring agent list --category business

Search Agents#

bootspring agent search "authentication"

Output:

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

Invoke an Agent#

bootspring agent invoke frontend-expert

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

Skill Commands#

List Skills#

bootspring skill list

Output:

Authentication (auth/) ────────────────────── clerk Clerk authentication setup nextauth NextAuth.js configuration oauth OAuth provider integration ... Database (database/) ──────────────────── prisma-crud Prisma CRUD operations queries Optimized query patterns ...

Filter by category:

bootspring skill list --category auth bootspring skill list --category payments

Search Skills#

bootspring skill search "stripe"

Output:

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

Show a Skill#

bootspring skill show payments/subscriptions

Displays the full skill content with code examples.

Workflow Commands#

List Workflows#

bootspring workflow list

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#

bootspring workflow start feature-development

Check Workflow Status#

bootspring workflow status

Output:

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

Resume/Pause Workflows#

# Pause a running workflow bootspring workflow pause feat-dev-abc123 # Resume a paused workflow bootspring workflow resume feat-dev-abc123

Quality Commands#

Run Quality Gates#

1# Run pre-commit checks 2bootspring quality pre-commit 3 4# Run pre-push checks 5bootspring quality pre-push 6 7# Run all gates 8bootspring quality all

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#

bootspring quality pre-commit --files src/components/Button.tsx

Context Commands#

View Context#

# Show current context summary bootspring context show # Show full context bootspring context show --full

Search Context#

bootspring context search "prisma"

Dashboard Commands#

Start Local Dashboard#

bootspring dashboard

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

  • Project status
  • Agent activity
  • Workflow progress
  • Quality results

Dashboard Options#

# Custom port bootspring dashboard --port 4000 # Open in browser automatically bootspring dashboard --open

Authentication Commands#

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

Login#

bootspring auth login

Opens your browser to:

  1. Authenticate with your account
  2. Select or create a project
  3. Link the current directory to that project

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

Check Auth Status#

bootspring auth status

Output:

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

Switch Projects#

1# List available projects 2bootspring switch 3 4# Link current directory to a different project 5bootspring switch my-other-project 6 7# Show current project link 8bootspring switch context show 9 10# Unlink current directory 11bootspring switch context clear

Logout#

bootspring auth logout

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

Configuration Commands#

Validate Config#

bootspring config validate

Show Effective Config#

bootspring config show

Reset Config#

bootspring config reset

Update Command#

Check for Updates#

bootspring update check

Update Bootspring#

bootspring update

Common Workflows#

Starting a New Project#

1# 1. Create project 2npx create-next-app@latest my-app 3cd my-app 4 5# 2. Authenticate and link to a project 6bootspring auth login 7# → Opens browser for sign-in and project selection 8# → Creates .bootspring.json 9 10# 3. Initialize Bootspring 11bootspring init 12 13# 4. Verify setup 14bootspring doctor 15 16# 5. Open AI assistant and start building!

Daily Development#

1# Morning: Update context if needed 2bootspring generate 3 4# During development: Use agents via AI assistant 5# "Use the frontend-expert to..." 6 7# Before commit: Run quality gate 8bootspring quality pre-commit 9 10# Before push: Run thorough checks 11bootspring quality pre-push

Starting a Workflow#

1# 1. List available workflows 2bootspring workflow list 3 4# 2. Start the workflow 5bootspring workflow start feature-development 6 7# 3. Monitor progress 8bootspring workflow status 9 10# 4. Resume if paused 11bootspring workflow resume <workflow-id>

Command Reference#

CommandDescription
bootspring initInitialize project
bootspring generateGenerate CLAUDE.md
bootspring doctorCheck setup
bootspring agent listList agents
bootspring agent invoke <name>Invoke agent
bootspring skill listList skills
bootspring skill show <name>Show skill
bootspring workflow listList workflows
bootspring workflow start <name>Start workflow
bootspring workflow statusCheck status
bootspring quality <gate>Run quality gate
bootspring context showShow context
bootspring dashboardStart dashboard
bootspring auth loginAuthenticate
bootspring auth statusCheck auth
bootspring config showShow config
bootspring updateUpdate CLI

Getting Help#

Command Help#

bootspring --help bootspring agent --help bootspring skill --help

Verbose Output#

Add --verbose or -v for detailed output:

bootspring generate --verbose

Debug Mode#

BOOTSPRING_DEBUG=true bootspring <command>

Environment Variables#

VariableDescription
BOOTSPRING_API_KEYYour API key
BOOTSPRING_DEBUGEnable debug mode
BOOTSPRING_PORTDefault server port
BOOTSPRING_TIMEOUTRequest timeout (ms)

Tips#

Aliases#

Add aliases to your shell config:

# ~/.zshrc or ~/.bashrc alias bs="bootspring" alias bsg="bootspring generate" alias bsq="bootspring quality pre-commit" alias bsd="bootspring doctor"

Auto-completion#

Enable tab completion:

# For bash bootspring completion bash >> ~/.bashrc # For zsh bootspring completion zsh >> ~/.zshrc

Quick Context Refresh#

After significant changes:

bootspring generate && git add CLAUDE.md

Next Steps#