Quick Start Guide

Ship your first Bootspring-driven flow in minutes.

Prerequisites#

• Node.js 18+
• A project directory
• Bootspring installed globally

First-Time Setup#

Install and initialize offline-first — no account required for local MCP, hooks, and project files:

init detects your stack, writes project config, and can register MCP for your assistant (--for claude, --for cursor, --for codex, etc.). Authenticate later only when you need hosted API features:

One-Command Setup#

The fastest way to go from zero to building:

This single command runs the entire workflow:

1. Detect -- scans your package.json for stack and features
2. Seed -- creates context document templates in .bootspring/context/
3. Merge -- combines documents into SEED.md
4. Generate -- creates AI context files (CLAUDE.md, AGENTS.md, CODEX.md, GEMINI.md) and planning/
5. Build init -- initializes the build state from planning/TODO.md

After go completes, edit planning/TODO.md with your real tasks and start building:

Path A: New Project (step-by-step)#

If you prefer more control over each step:

Or fully manual:

Path B: Existing Codebase#

Build Loop#

The daily workflow once setup is done:

Recovery and Queue Sync#

If build artifacts or runtime queue drift:

Help#

Next Steps#

• CLI Essentials
• Troubleshooting
• Build Command Reference