Bootspring
HomeGet Started

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:

npx bootspring init

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#

1# npm 2npm install -g bootspring 3 4# yarn 5yarn global add bootspring 6 7# pnpm 8pnpm add -g bootspring

2. Initialize Your Project#

Navigate to your project directory and run:

bootspring init

3. Configure Your AI Assistant#

For Claude Code / Claude Desktop#

The init command automatically creates .mcp.json:

1{ 2 "mcpServers": { 3 "bootspring": { 4 "command": "npx", 5 "args": ["-y", "bootspring", "serve"], 6 "env": {} 7 } 8 } 9}

For Cursor#

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

1{ 2 "mcpServers": { 3 "bootspring": { 4 "command": "npx", 5 "args": ["-y", "bootspring", "serve"] 6 } 7 } 8}

For VS Code with Continue#

Add to your Continue configuration:

1{ 2 "mcpServers": [ 3 { 4 "name": "bootspring", 5 "command": "npx", 6 "args": ["-y", "bootspring", "serve"] 7 } 8 ] 9}

Verify Installation#

After installation, verify Bootspring is working:

1# Check version 2bootspring --version 3 4# List available agents 5bootspring agents list 6 7# List available tools 8bootspring tools list

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:

1# npm 2npm update -g bootspring 3 4# yarn 5yarn global upgrade bootspring 6 7# pnpm 8pnpm update -g bootspring

Uninstalling#

To remove Bootspring from a project:

# Remove configuration files rm bootspring.config.js .mcp.json # Optionally remove global package npm uninstall -g bootspring

Troubleshooting#

"Command not found: bootspring"#

Ensure the global npm bin directory is in your PATH:

# Find npm global bin path npm config get prefix # Add to PATH (add to ~/.bashrc or ~/.zshrc) export PATH="$(npm config get prefix)/bin:$PATH"

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:

mkdir -p ~/.npm-global npm config set prefix '~/.npm-global' export PATH=~/.npm-global/bin:$PATH

Next Steps#