Windows Setup Guide

Complete guide to installing and configuring Bootspring on Windows.

System Requirements#

Installation Methods#

Method 1: Chocolatey (Recommended)#

Method 2: Windows Package Manager (winget)#

Method 3: Node.js Installer#

1. Download from nodejs.org
2. Run the installer
3. Restart terminal
4. Install Bootspring:

Method 4: nvm-windows#

For managing multiple Node.js versions:

Terminal Options#

Windows Terminal (Recommended)#

Install from Microsoft Store or:

Configure in Settings (Ctrl+,):

PowerShell 7#

Git Bash#

Included with Git for Windows:

WSL 2 (Windows Subsystem for Linux)#

For a Linux-like experience:

PowerShell Configuration#

Profile Setup#

Open PowerShell profile:

Add completions and aliases:

Save and reload:

Execution Policy#

If scripts are blocked:

Authentication#

Browser Login#

Opens your default browser for authentication.

Device Code#

For terminals without browser access:

Environment Variable#

For CI/CD and automation:

Project Setup#

Initialize Project#

Interactive Mode#

Quick Setup#

VS Code Integration#

Install VS Code#

Install Extension#

Or via VS Code:

1. Open Extensions (Ctrl+Shift+X)
2. Search "Bootspring"
3. Install

Configure Extension#

Settings (Ctrl+,):

Integrated Terminal#

VS Code uses PowerShell by default. Bootspring works seamlessly:

Claude Desktop Integration#

Install Claude Desktop#

1. Download from claude.ai/download
2. Run the installer
3. Sign in with your Anthropic account

Configure MCP Server#

Manual Configuration#

If automatic setup fails, edit: %APPDATA%\Claude\claude_desktop_config.json

Verify MCP#

1. Restart Claude Desktop
2. Check for "bootspring" in available tools
3. Test: "Use bootspring_context to describe this project"

JetBrains IDE Setup#

Install Plugin#

1. Open Settings (Ctrl+Alt+S)
2. Plugins → Marketplace
3. Search "Bootspring"
4. Install and restart

Terminal Configuration#

Settings → Tools → Terminal:

• Shell path: pwsh.exe or C:\Program Files\PowerShell\7\pwsh.exe

Run Configurations#

Create a Run Configuration for Bootspring:

1. Run → Edit Configurations
2. Add → Shell Script
3. Script: bootspring generate

Windows Defender Configuration#

Windows Defender may scan Node.js operations, causing slowdowns.

Add Exclusions#

Verify Exclusions#

Path Configuration#

Check PATH#

Add npm Global to PATH#

WSL 2 Setup#

For a Linux-like experience on Windows:

Enable WSL 2#

Install Ubuntu#

Configure WSL#

Inside WSL:

Access Windows Projects#

VS Code with WSL#

1. Install "Remote - WSL" extension
2. Open folder in WSL: code . from WSL terminal

Credential Manager#

Store API key securely:

Using cmdkey#

Using PowerShell SecretManagement#

Troubleshooting#

'bootspring' is not recognized#

Permission Denied#

SSL Certificate Errors#

Long Path Issues#

Enable long paths in Windows:

Antivirus Blocking#

If antivirus software blocks Bootspring:

1. Add exclusion for node.exe
2. Add exclusion for npm global directory
3. Add exclusion for project directories

PowerShell Execution Policy#

Health Check#

Expected output:

Uninstallation#

Remove Bootspring#

Clean Configuration#

Remove Environment Variables#

Remove MCP Configuration#

Edit %APPDATA%\Claude\claude_desktop_config.json and remove the bootspring entry.

Next Steps#

• Generate Context
• VS Code Setup
• Claude Desktop Setup
• Your First Workflow