Cursor Setup Guide

Complete guide to integrating Bootspring with Cursor, the AI-powered code editor.

Overview#

Cursor is an AI-enhanced code editor built on VS Code. Bootspring complements Cursor by providing:

• Structured Context - CLAUDE.md enhances Cursor's understanding
• Expert Agents - Specialized assistance beyond general AI
• Skill Patterns - Production-ready code patterns
• Development Workflows - Multi-phase orchestration

Prerequisites#

• Cursor installed (cursor.sh)
• Bootspring CLI installed (npm install -g bootspring)
• Node.js 18+ installed

Installing Cursor#

macOS#

Windows#

Download from cursor.sh and run the installer.

Linux#

Bootspring Integration#

Step 1: Initialize Bootspring#

This creates:

• CLAUDE.md - Context file (Cursor reads this)
• bootspring.config.js - Configuration
• .bootspring/ - Local data

Step 2: Cursor Reads CLAUDE.md#

Cursor automatically indexes your project, including CLAUDE.md. This provides:

• Project architecture understanding
• Coding standards and patterns
• Tech stack details
• Custom instructions

Step 3: Configure Cursor Rules#

Create .cursorrules to reference Bootspring context:

Syncing Context#

Context in CLAUDE.md#

Bootspring generates comprehensive context:

Regenerate After Changes#

Git Hook#

Auto-generate on commit:

Using Both Together#

Cursor for Quick Edits#

Use Cursor's built-in AI for:

• Line completions (Tab)
• Quick edits (Cmd+K)
• Simple questions (Cmd+L)

Bootspring for Complex Tasks#

Use Bootspring CLI for:

• Expert agent consultations
• Production pattern application
• Multi-phase workflows

Terminal Integration#

Cursor Terminal#

Cursor includes an integrated terminal. Use Bootspring directly:

Completions#

Add to your shell profile:

Composer Integration#

Using Composer with Context#

When using Cursor's Composer (Cmd+I):

1. Composer reads your CLAUDE.md
2. Uses project patterns for generation
3. Follows your coding standards

Reference Bootspring Context#

In Composer prompts:

Add Context References#

Custom Commands#

Cursor Command Palette#

Create .vscode/tasks.json (Cursor uses VS Code format):

Run via: Cmd+Shift+P → "Tasks: Run Task"

Keyboard Shortcuts#

Cursor Shortcuts#

Custom Bootspring Shortcuts#

Add to Cursor keybindings:

Settings Synchronization#

Cursor Settings#

.vscode/settings.json:

Bootspring Settings#

bootspring.config.js:

Workflow: Cursor + Bootspring#

Feature Development#

1. Plan with Bootspring

   Loading code block...

2. Design phase - Bootspring agent provides architecture

3. Implement in Cursor - Use Composer for code generation

4. Apply patterns

   Loading code block...

5. Quality check

   Loading code block...

6. Commit - Context auto-updates

Code Review#

1. Run security review

   Loading code block...

2. Fix issues in Cursor - Use Cmd+K for inline fixes

3. Verify with quality check

   Loading code block...

Cursor Rules Best Practices#

Reference CLAUDE.md#

Project-Specific Rules#

Troubleshooting#

Context Not Updating#

Cursor Not Reading CLAUDE.md#

1. Check file exists: ls CLAUDE.md
2. Verify it's not gitignored
3. Reload Cursor window
4. Re-index project: Cmd+Shift+P → "Cursor: Re-index"

Terminal Commands Failing#

Conflicting AI Suggestions#

If Cursor's suggestions conflict with Bootspring patterns:

1. Update .cursorrules to reference CLAUDE.md
2. Be explicit about pattern preferences
3. Use Bootspring for complex generation

Performance#

Optimize Context Generation#

Cursor Indexing#

Cursor indexes your project. Large contexts may slow indexing:

• Keep CLAUDE.md focused
• Use .cursorignore for large files
• Exclude generated content

Extensions#

Recommended Extensions#

Install via Cursor's extension panel:

Extension Settings#

Next Steps#

• Understanding Context
• Using Agents
• Using Skills
• Claude Desktop Setup