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, Codex, Cursor, etc.)

Quick Install#

The fastest way to get started:

Loading code block...

This command will:

  1. Create a bootspring.config.js configuration file
  2. Set up the MCP server configuration in .mcp.json
  3. Generate a CLAUDE.md context file for your project

Manual Installation#

1. Install the Package#

Loading code block...

2. Authenticate#

Log in to Bootspring and link your project:

Loading code block...

This will:

  1. Open your browser for secure authentication
  2. Let you select an existing project or create a new one
  3. Create a .bootspring.json file linking this directory to your project

3. Initialize Your Project#

Navigate to your project directory and run:

Loading code block...

4. Configure Your AI Assistant#

For Claude Code / Claude Desktop#

The init command automatically creates .mcp.json:

Loading code block...

For Cursor#

Add to your Cursor settings (~/.cursor/mcp.json):

Loading code block...

For VS Code with Continue#

Add to your Continue configuration:

Loading code block...

Verify Installation#

After installation, verify Bootspring is working:

Loading code block...

Project Structure#

After initialization, your project will have:

your-project/ ├── bootspring.config.js # Bootspring configuration ├── .mcp.json # MCP server configuration ├── CLAUDE.md # AI context file (auto-generated) └── ... your existing files

Updating Bootspring#

To update to the latest version:

Loading code block...

Uninstalling#

To remove Bootspring from a project:

Loading code block...

Troubleshooting#

"Command not found: bootspring"#

Ensure the global npm bin directory is in your PATH:

Loading code block...

MCP Server Not Connecting#

  1. Restart your AI assistant
  2. Check .mcp.json exists in your project root
  3. Verify Node.js version: node --version

Permission Errors#

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

Loading code block...

Next Steps#