Config Commands | Bootspring Docs

Manage Bootspring configuration from the command line.

Synopsis#

bootspring config <command> [options]

Commands#

Command	Description
`show`	Show current configuration
`set <key> <value>`	Set a configuration value
`get <key>`	Get a configuration value
`validate`	Validate configuration file
`reset`	Reset to defaults

bootspring config show#

Display current configuration.

Usage#

bootspring config show [options]

Options#

Option	Description
`--json`	Output as JSON
`--section <name>`	Show specific section

Example#

bootspring config show

Output:

Bootspring Configuration
═══════════════════════════════════════════════════════════════════

Project
───────
Name:        my-awesome-app
Type:        saas
Description: AI-powered project management

Stack
─────
Frontend:    react, nextjs, tailwindcss
Backend:     nodejs
Database:    postgresql, prisma
Auth:        clerk
Payments:    stripe

Agents
──────
Enabled:     all
Custom Instructions:
  frontend-expert: Use TypeScript strict mode, prefer server components

Quality
───────
Pre-commit:  lint, format, types
Pre-push:    tests (80% coverage), build
Pre-deploy:  e2e, security, a11y

Paths
─────
Context:     CLAUDE.md
Todo:        todo.md
PRD:         tasks/prd.json

───────────────────────────────────────────────────────────────────
Config file: bootspring.config.js

# Show as JSON
bootspring config show --json

# Show specific section
bootspring config show --section quality

bootspring config set#

Set a configuration value.

Usage#

bootspring config set <key> <value>

Examples#

# Set project name
bootspring config set project.name "my-new-app"

# Set quality threshold
bootspring config set quality.prePush.coverage 85

# Enable specific agents
bootspring config set agents.enabled "frontend-expert,backend-expert,database-expert"

# Set path
bootspring config set paths.todo "docs/tasks.md"

Output:

Set project.name = "my-new-app"

Updated bootspring.config.js

bootspring config get#

Get a specific configuration value.

Usage#

bootspring config get <key>

Examples#

bootspring config get project.name
# Output: my-awesome-app

bootspring config get quality.prePush.coverage
# Output: 80

bootspring config get agents.enabled
# Output: all

bootspring config validate#

Validate the configuration file.

Usage#

bootspring config validate [options]

Options#

Option	Description
`--fix`	Auto-fix common issues

Example#

bootspring config validate

Output (valid):

Configuration Validation
═══════════════════════════════════════════════════════════════════

✓ Config file exists
✓ Valid JavaScript syntax
✓ Required fields present
✓ Stack configuration valid
✓ Agent names valid
✓ Quality settings valid
✓ Paths valid

───────────────────────────────────────────────────────────────────
Configuration is valid

Output (invalid):

Configuration Validation
═══════════════════════════════════════════════════════════════════

✓ Config file exists
✓ Valid JavaScript syntax
✗ Invalid agent name: 'frontent-expert' (did you mean 'frontend-expert'?)
✗ Quality coverage must be between 0-100 (got: 150)

───────────────────────────────────────────────────────────────────
2 errors found

Fix with: bootspring config validate --fix

bootspring config reset#

Reset configuration to defaults.

Usage#

bootspring config reset [options]

Options#

Option	Description
`--section <name>`	Reset specific section only
`--force`	Don't ask for confirmation

Example#

bootspring config reset

Output:

? Reset all configuration to defaults? (y/N) y

Configuration reset to defaults

Regenerating CLAUDE.md...
Done

# Reset specific section
bootspring config reset --section quality

# Reset without confirmation
bootspring config reset --force

Configuration File#

Location#

Bootspring looks for configuration in:

bootspring.config.js (recommended)
bootspring.config.mjs
bootspring.config.cjs

Structure#

// bootspring.config.js
module.exports = {
  // Project information
  project: {
    name: 'my-app',
    type: 'saas',
    description: 'My awesome application',
  },

  // Tech stack
  stack: {
    frontend: ['react', 'nextjs', 'tailwindcss'],
    backend: ['nodejs'],
    database: ['postgresql', 'prisma'],
    auth: ['clerk'],
    payments: ['stripe'],
    testing: ['vitest', 'playwright'],
  },

  // Agent configuration
  agents: {
    enabled: 'all',  // or array of names
    customInstructions: {
      'frontend-expert': 'Use TypeScript strict mode',
    },
  },

  // Skill preferences
  skills: {
    preferences: {
      auth: 'clerk',
      payments: 'stripe',
    },
  },

  // Quality gates
  quality: {
    preCommit: {
      lint: true,
      format: true,
      types: true,
    },
    prePush: {
      tests: true,
      coverage: 80,
    },
    preDeploy: {
      e2e: true,
      security: true,
    },
  },

  // Context generation
  context: {
    exclude: ['**/node_modules/**', '**/dist/**'],
    customSections: [
      {
        title: 'Team Guidelines',
        content: 'Our coding standards...',
      },
    ],
  },

  // File paths
  paths: {
    context: 'CLAUDE.md',
    todo: 'todo.md',
    prd: 'tasks/prd.json',
  },

  // Dashboard settings
  dashboard: {
    port: 3456,
  },
};

Environment Variables#

Some settings can be set via environment variables:

Variable	Description
`BOOTSPRING_API_KEY`	API key
`BOOTSPRING_CONFIG`	Config file path
`BOOTSPRING_DEBUG`	Enable debug mode

# Set API key
export BOOTSPRING_API_KEY=bsk_your_key

# Use custom config file
export BOOTSPRING_CONFIG=./config/bootspring.js

bootspring init - Initial setup
Configuration Guide - Full reference
bootspring_config - MCP tool reference