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

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

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)

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

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

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.