BoB — Big ol' Brain

Appearance

Getting Started ​

Your first lap with BoB. Stand up a project, then run the autonomous loop. Extracted from the handbook's Quick Start and first-time-install sections — read top to bottom.

← docs home · the conceptual spine is the handbook.

2. Quick Start ​

2A. Brand-new project ​

bash
cd ~/Sites/my-project           # Project must be a git repo

cdi                             # Wire up .claude/ symlinks
cdprov                          # Provision skills/commands/agents from manifest
claude                          # Start Claude Code

# Inside Claude:
/vision                         # Living doc: why, who, where (docs/vision.md)
/capability                     # First feature spec (GitHub Issue, label: cap)
/requirement                    # Acceptance criteria (GitHub Issue, label: req)
# Approve a requirement: add the `approved` label

2B. Existing project ​

bash
cd ~/Sites/my-project
cdb                             # Sanity-check tooling status
cdprov --status                 # See what's provisioned
claude

Inside Claude:

/what-next                      # Tells you the next sensible work item

2C. Autonomous mode (warp-drive) ​

bash
claude -a3 -rdb                 # Level 3 + Telegram bridge

Inside Claude:

/warp-drive                     # Picks up next approved requirement and goes

Phone nearby. Decisions land in Telegram. /stop-warp-drive to abort cleanly.

2D. Parallel work clusters ​

bash
cdfork fork feat/a feat/b feat/c        # 3 worktrees, 3 tmux windows, 3 warp-drives
cdfork fork --from-issues 4              # Auto-pick 4 approved requirements
cdfork status                            # See every active worktree
cdfork drop feat/a                       # Tear down one cleanly

3.1 First-time install on a machine ​

bash
git clone git@github.com:paulirv/bigbrain.git ~/projects/bigbrain
cd ~/projects/bigbrain

scripts/bob-install.sh           # Adds BoB shell wrapper + aliases to your shell rc
source ~/.zshrc                  # (or ~/.bashrc) — picks up wrapper + aliases

scripts/deploy.sh --first-run    # Sync source → ~/.claude/ for the first time

What bob-install.sh adds to your shell rc:

  • claude shell wrapper — intercepts -a1 / -a2 / -a3 (automation level) and -rdb (Telegram), then exec's the real claude CLI.
  • Aliases: cdprov, cdr, cdfork.