Installation

Get Bootspring installed and running in under a minute.

Prerequisites#

• Node.js 18.0 or higher
• npm, yarn, or pnpm
• An MCP-compatible AI assistant (Claude Code, Codex, Cursor, Zed, etc.)

Quick Install#

This will:

1. Install the CLI globally
2. Authenticate via browser
3. Create .bootspring.json and initialize memory
4. Wire up assistant hooks for Claude Code and Codex

Manual Installation#

1. Install the Package#

2. Authenticate#

Log in to Bootspring and link your project:

This will:

1. Open your browser for secure authentication
2. Let you select an existing project or create a new one

3. Initialize Your Project#

Navigate to your project directory and run:

This creates .bootspring.json, initializes .bootspring/memory/ with default blocks, detects your stack, and copies relevant skills and agents.

4. Install Hooks#

This writes hook config to .claude/settings.local.json and .codex/hooks.json, enabling automatic memory injection, stats collection, and suggestions.

5. Configure Your AI Assistant#

Register Bootspring's MCP server for your assistant:

This writes the MCP server configuration to the correct location for each client.

Verify Installation#

After installation, verify Bootspring is working:

Project Structure#

After initialization, your project will have:

Updating Bootspring#

To update to the latest version:

Uninstalling#

To remove Bootspring from a project:

Troubleshooting#

"Command not found: bootspring"#

Ensure the global npm bin directory is in your PATH:

MCP Server Not Connecting#

1. Run bootspring init --for claude (or your client) to write the MCP config
2. Restart your AI assistant
3. Verify Node.js version: node --version

Permission Errors#

On macOS/Linux, you may need to fix npm permissions:

Next Steps#

• Quick Start Guide - Build your first project
• Configuration - Customize Bootspring
• Agents Overview - Meet the expert agents