CLI Reference
Complete reference for Bootspring command-line interface.
Installation#
# Global installation
npm install -g bootspring
# Or use npx
npx bootspring <command>Commands#
init#
Initialize Bootspring in a project.
bootspring init [options]Options:
| Option | Description |
|---|---|
--yes, -y | Skip prompts, use defaults |
--force, -f | Overwrite existing files |
--template <name> | Use a specific template |
Example:
bootspring init
bootspring init --yes
bootspring init --template nextjsserve#
Start the MCP server.
bootspring serve [options]Options:
| Option | Description |
|---|---|
--port <port> | Server port (default: 3100) |
--config <path> | Config file path |
--debug | Enable debug logging |
Example:
bootspring serve
bootspring serve --port 3200
bootspring serve --debugagents#
Manage and invoke agents.
bootspring agents <subcommand> [options]Subcommands:
| Subcommand | Description |
|---|---|
list | List all available agents |
info <name> | Show agent details |
invoke <name> | Invoke an agent |
Example:
bootspring agents list
bootspring agents info frontend-expert
bootspring agents invoke frontend-expert --context "Create a button component"skills#
Browse and apply skill patterns.
bootspring skills <subcommand> [options]Subcommands:
| Subcommand | Description |
|---|---|
list | List all available skills |
search <query> | Search skills |
info <name> | Show skill details |
apply <name> | Apply a skill |
Example:
bootspring skills list
bootspring skills search "api"
bootspring skills apply api-endpoint --method POST --path /api/usersquality#
Run quality gates.
bootspring quality [options]Options:
| Option | Description |
|---|---|
--gate <name> | Gate to run (pre-commit, pre-push, pre-deploy) |
--fix | Auto-fix issues |
--files <pattern> | Specific files to check |
Example:
bootspring quality --gate pre-commit
bootspring quality --gate pre-commit --fix
bootspring quality --files "src/**/*.ts"context#
Manage project context.
bootspring context <subcommand> [options]Subcommands:
| Subcommand | Description |
|---|---|
generate | Generate CLAUDE.md |
update | Update existing context |
validate | Validate context file |
Example:
bootspring context generate
bootspring context update
bootspring context validateconfig#
Manage configuration.
bootspring config <subcommand> [options]Subcommands:
| Subcommand | Description |
|---|---|
show | Show current configuration |
validate | Validate configuration |
set <key> <value> | Set a configuration value |
Example:
bootspring config show
bootspring config validate
bootspring config set quality.thresholds.coverage 90upgrade#
Check for and install updates.
bootspring upgrade [options]Options:
| Option | Description |
|---|---|
--check | Check for updates only |
--yes | Auto-confirm upgrade |
Example:
bootspring upgrade --check
bootspring upgradehelp#
Display help information.
bootspring help [command]
bootspring <command> --helpGlobal Options#
These options work with all commands:
| Option | Description |
|---|---|
--version, -v | Show version |
--help, -h | Show help |
--quiet, -q | Suppress output |
--verbose | Verbose output |
--no-color | Disable colors |
Exit Codes#
| Code | Description |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Invalid arguments |
| 3 | Configuration error |
| 4 | Quality gate failed |
Environment Variables#
| Variable | Description |
|---|---|
BOOTSPRING_API_KEY | API key for premium features |
BOOTSPRING_DEBUG | Enable debug mode |
BOOTSPRING_NO_COLOR | Disable colored output |