Bootspring

Development scaffolding with intelligence

Bootspring is an AI-powered development platform that provides intelligent context, specialized agents, and workflow automation for any MCP-compatible AI assistant.

Features

• Preseed → Seed → Scaffold Pipeline - Go from idea to working code with AI-assisted document generation
• Universal Drop Zone - Drop any files and let AI analyze and categorize them for you
• Intelligent Context Management - Automatically generates and maintains AI context for your project
• Specialized Agents - 12+ expert agents for database, security, frontend, backend, and more
• MCP Integration - Native Model Context Protocol server for seamless AI assistant integration
• Entitlement-Ready Skill Catalog - Built-in patterns public, curated external catalog policy-gated
• Plugin System - Extensible architecture for auth, payments, database, testing, security
• Real-time Dashboard - Visual project tracking with live updates
• Quality Gates - Automated code quality and security checks
• Todo Management - Simple, powerful task tracking

Quick Start

# Install globally
npm install -g @girardmedia/bootspring

# Start a new project from an idea
bootspring preseed start
bootspring seed synthesize
bootspring seed scaffold --preset=nextjs

# Or initialize in an existing project
bootspring init

New Project Workflow (Recommended)

# 1. Capture your idea with preseed
bootspring preseed start

# 2. Convert preseed docs to SEED.md
bootspring seed synthesize

# 3. Scaffold your project
bootspring seed scaffold --preset=nextjs

# 4. Start development
npm install && npm run dev

Authentication

Bootspring uses browser-based device flow authentication for security.

# Login via browser (opens browser for authentication)
bootspring auth login

# View authentication and project status
bootspring auth status

# Logout from all projects
bootspring auth logout

How It Works

1. Global credentials are stored in ~/.bootspring/credentials.json
2. Each directory is linked to a specific project via .bootspring.json
3. Login opens your browser to authenticate and select/create a project

# First login in a directory:
cd my-project
bootspring auth login
# → Opens browser → Sign in → Select project → Creates .bootspring.json

# Subsequent use:
bootspring auth login
# → "Already authenticated as [email protected]"
# → "Project: my-project (from .bootspring.json)"

Per-Directory Project Linking

Each directory can be linked to a different Bootspring project:

~/projects/frontend/    → "frontend-app" project
~/projects/backend/     → "backend-api" project
~/projects/mobile/      → "mobile-app" project

Switch projects with:

bootspring switch my-other-project

Device Management

Each account has a device limit based on your subscription tier:

| Tier | Max Devices | |------|-------------| | Free | 2 | | Pro | 5 | | Team | 10 | | Enterprise | 50 |

Your devices are automatically tracked when you login. If you hit your device limit, logout from another device or upgrade your plan.

Commands

Getting Started

bootspring init              # Initialize Bootspring in your project
bootspring generate          # Generate/regenerate CLAUDE.md context
bootspring dashboard         # Start the real-time dashboard

Preseed (Idea Capture)

bootspring preseed start         # Smart entry point - recommended first command
bootspring preseed setup         # Create context folders including drop zone
bootspring preseed init          # Interactive document generation wizard
bootspring preseed workflow start # Begin document approval workflow
bootspring preseed pull/push     # Sync with cloud dashboard

Seed (Project Scaffolding)

bootspring seed synthesize       # Create SEED.md from preseed documents
bootspring seed scaffold --preset=nextjs  # Generate project from preset
bootspring seed init --preset=startup     # Interactive project config

Daily Workflow

bootspring todo add "task"   # Add a new todo
bootspring todo list         # List all todos
bootspring todo done 1       # Mark todo #1 as complete
bootspring context           # View project context summary
bootspring context validate  # Validate project setup

Intelligence

bootspring agent list        # List available agents
bootspring agent show <name> # Show agent details
bootspring agent invoke <n>  # Get specialized help (MCP enhanced)
bootspring skill search <q>  # Find code patterns
bootspring skill show <name> # View skill content (MCP enhanced)
bootspring skill list --external  # Include curated external catalog
bootspring orchestrator workflows  # List workflows and premium packs
bootspring telemetry status  # Inspect local telemetry pipeline

Note: Commands marked "MCP enhanced" provide full functionality through MCP integration but offer degraded (but useful) CLI mode. Run bootspring mcp start to enable full features.

Premium workflow packs:

• launch-pack (pro)
• reliability-pack (pro)
• growth-pack (pro)

Workflow telemetry (stored locally in .bootspring/telemetry/events.jsonl):

• workflow_started
• workflow_step_advanced
• workflow_checkpoint_completed
• pack_signal_checkpoint
• workflow_completed

External Skill Entitlements

Built-in skills are always available. Curated external skills (external/*) are policy-gated via a shared entitlement layer:

• Local mode (default): external skills are available when present.
• Server mode: external skills require entitlement.

# Server-side policy mode (for hosted API/MCP)
export BOOTSPRING_SKILL_ACCESS_MODE=server

# Grant entitlement in server mode
export BOOTSPRING_SKILLS_ENTITLED=true
# or
export BOOTSPRING_USER_TIER=pro

Remote premium delivery (cache-first):

bootspring skill sync \
  --manifest-url https://api.bootspring.com/skills/manifest.json \
  --content-base-url https://api.bootspring.com/skills/content

Recommended for production:

export BOOTSPRING_SKILL_MANIFEST_REQUIRE_SIGNATURE=true
export BOOTSPRING_SKILL_MANIFEST_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----..."

PRD Markdown

intelligence/prd supports both hand-written and exported story headings:

• ## Story 1: Title
• ### [ ] Title (export format from toMarkdown())

Top-level description text should appear after the # Title and before story headings.

Quality & Plugins

bootspring quality pre-commit  # Run pre-commit checks
bootspring plugin list         # List available plugins
bootspring plugin enable auth  # Enable a plugin

Agents

Bootspring includes 12+ specialized agents:

| Agent | Expertise | |-------|-----------| | database-expert | SQL, Prisma, PostgreSQL, migrations | | security-expert | OWASP, authentication, authorization | | frontend-expert | React, Next.js, Tailwind, components | | backend-expert | Node.js, APIs, server actions | | api-expert | REST, GraphQL, tRPC, webhooks | | testing-expert | Vitest, Jest, Playwright, coverage | | performance-expert | Optimization, caching, profiling | | devops-expert | CI/CD, Docker, deployment | | ui-ux-expert | Design systems, accessibility | | architecture-expert | System design, patterns | | code-review-expert | Code quality, best practices | | vercel-expert | Vercel, serverless, edge |

Configuration

Create bootspring.config.js in your project root:

module.exports = {
  project: {
    name: 'My App',
    description: 'A modern web application'
  },
  stack: {
    framework: 'nextjs',
    language: 'typescript',
    database: 'postgresql',
    hosting: 'vercel'
  },
  plugins: {
    auth: { enabled: true, provider: 'clerk' },
    payments: { enabled: true, provider: 'stripe' },
    database: { enabled: true, provider: 'prisma' },
    testing: { enabled: true, provider: 'vitest' },
    security: { enabled: true }
  },
  dashboard: {
    port: 3456
  }
};

MCP Integration

Bootspring works as an MCP server for Claude Code and other compatible AI assistants.

Configure in .mcp.json:

{
  "mcpServers": {
    "bootspring": {
      "command": "npx",
      "args": ["@girardmedia/bootspring", "mcp"],
      "env": {}
    }
  }
}

Available MCP tools:

• bootspring_context - Show/validate project context
• bootspring_agent - Invoke specialized agents
• bootspring_capabilities - Discover client-adaptive capabilities by tier/mode
• bootspring_skill - Retrieve code patterns
• bootspring_telemetry - List/upload/clear telemetry events
• bootspring_todo - Manage todo items
• bootspring_task - Manage complex tasks
• bootspring_quality - Run quality gates
• bootspring_generate - Regenerate context
• bootspring_dashboard - Control dashboard

Project Structure

your-project/
├── bootspring.config.js    # Configuration
├── CLAUDE.md               # Generated AI context
├── todo.md                 # Task tracking
├── .mcp.json               # MCP server config
└── ...

Why Bootspring?

Before Bootspring:

• Manual context management for AI assistants
• Inconsistent code patterns across projects
• No specialized expertise on demand
• Manual quality checks

With Bootspring:

• Automatic context generation and updates
• Battle-tested code patterns via skills
• 12+ specialized agents at your fingertips
• Automated quality gates
• Real-time project visibility

Documentation

• Getting Started
• Configuration
• Agents
• Skills
• Plugins
• MCP Integration
• Planning Workspace
• MCP API Platform

Development

Shared Database Schema

The Bootspring API server (server/) and the website (bootspring-site/) share a PostgreSQL database. The canonical schema is in shared/db/schema.sql.

# To make schema changes:
# 1. Edit the canonical schema
vim shared/db/schema.sql

# 2. Sync to both repos
npm run db:sync

# 3. Run server migration
cd server && npm run migrate

# 4. Run site migration
cd ../bootspring-site && npm run db:push

See shared/db/README.md for full documentation.

Contributing

Contributions are welcome! Please see our Contributing Guide.

License

MIT License - see LICENSE for details.

Bootspring - Bootstrap your development. Spring into production.

Website · Documentation · GitHub