Quick Start

Get Barbossa running in 5 minutes.

Requirements

Docker - Install
Claude Max - Subscribe (required for Claude Code CLI)
GitHub CLI - Install
macOS or Linux - Windows via WSL2

No SSH keys required - uses HTTPS with GitHub CLI authentication.

Setup

# 1. Authenticate
gh auth login
claude login

# 2. Clone and configure
git clone https://github.com/ADWilkinson/barbossa-dev.git
cd barbossa-dev
cp config/repositories.json.example config/repositories.json

# 3. Edit config with your repository
nano config/repositories.json

# 4. Start
docker compose up -d

# 5. Verify
docker exec barbossa barbossa health

Tip: Use Claude to help configure! Give it llms.txt for context.

Commands

docker exec barbossa barbossa health          # Check status
docker exec barbossa barbossa run engineer    # Run now
docker exec barbossa barbossa status          # Activity
docker compose logs -f                        # Logs

What Happens Next

Barbossa runs automatically:

Discovery finds issues and adds them to backlog
Engineer picks from backlog and creates PRs
Tech Lead reviews PRs and merges good ones

You wake up to PRs already merged. Set auto_merge: false in config if you prefer to merge manually.

Next Steps

Configuration - All config options
Agents - How agents work
Troubleshooting - Common issues