Quick Start Guide

Ship your first Bootspring-driven flow in minutes.

Prerequisites#

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

First-Time Setup#

Before starting any project, install and authenticate:

Authentication is required before init and most other commands. The init command links your project, detects your stack, and initializes cross-session memory. Use bootspring init --for claude (or --for cursor, --for codex, etc.) to register MCP for your AI assistant.

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