Terminal Setup Guide

Complete guide to using Bootspring from the command line without any IDE integration.

Overview#

Bootspring works great as a standalone CLI tool, independent of any AI assistant or IDE. Perfect for:

• Server environments
• CI/CD pipelines
• Quick project setup
• Automation scripts
• Developers who prefer terminal workflows

Prerequisites#

• Node.js 18+ installed
• npm or yarn
• Terminal (bash, zsh, fish, PowerShell)

Installation#

Global Install (Recommended)#

Local Install#

Verify Installation#

Quick Start#

Initialize a New Project#

Initialize an Existing Project#

Core Workflows#

1. Project Setup#

2. Development Loop#

3. Business Planning#

4. Analysis & Audit#

5. Deployment#

Agent Interaction (CLI)#

List Available Agents#

Invoke an Agent#

Agent Output#

Agent responses are written to .bootspring/logs/ and displayed in the terminal.

Skill Patterns#

Browse Patterns#

Apply Patterns#

Patterns provide code snippets and implementation guidance:

Configuration#

Create Config File#

Config Structure#

Environment Variables#

Shell Completions#

Bash#

Zsh#

Fish#

Automation#

Git Hooks#

Pre-commit quality check:

Post-commit context update:

CI/CD Integration#

GitHub Actions:

Scripting#

Multi-Project Workflows#

Workspace Setup#

Run Across Projects#

Autonomous Workflows#

Loop Mode#

Run tasks autonomously:

Orchestrator#

Intelligent workflow coordination:

Output Formats#

JSON Output#

Many commands support --json for scripting:

Pipe to Other Tools#

Troubleshooting#

Common Issues#

Command not found:

Permission errors:

Node version:

Diagnostics#

Best Practices#

Project Structure#

Daily Workflow#

1. Morning:

   Loading code block...

2. Development:

   Loading code block...

3. End of day:

   Loading code block...

Next Steps#

• Claude Code Integration
• Cursor Integration
• VS Code Integration
• CI/CD Guide