Single Go binary that watches GitHub repos for todo-labeled issues, runs Claude Code, and creates PRs.

Releases | Discussions

Download the latest binary for your platform:

# macOS (Apple Silicon)
curl -fSL https://github.com/joeblew999/claude-bot/releases/download/latest/claude-bot-darwin-arm64 -o claude-bot
chmod +x claude-bot

# Or build from source
go build -o claude-bot .

# Or self-update an existing binary
./claude-bot --update

CB_REPOS="owner/repo" ./claude-bot

Or use the Taskfile:

task start    # build + run (idempotent)
task stop     # stop (idempotent)
task test     # unit tests
task release  # cross-compile + publish GitHub release
task update   # self-update from latest release
task clean    # remove worktrees + logs

1. Polls repos for issues labeled todo
2. Picks up issue, labels it in-progress
3. Clones repo, creates worktree on a new branch
4. Runs Claude Code with the issue as the prompt
5. Commits changes, pushes, creates PR
6. Comments PR link on issue, labels done
7. On failure: comments error, resets to todo, retries up to max

Everything is idempotent — safe to restart at any point.

Set CB_TRIAGE=1 to auto-respond to new unlabeled issues with a context-aware, human-sounding reply generated by Claude at runtime.

Set CB_TRIAGE_DISCUSSIONS=1 to also respond to new GitHub Discussions.

The binary manages its own lifecycle:

./claude-bot --build      # compile from source (embeds git commit)
./claude-bot --release    # cross-compile 6 targets + publish GitHub release
./claude-bot --update     # download latest release and replace self
./claude-bot --clean      # remove worktrees + logs
./claude-bot --clean-all  # full reset (worktrees, repos, logs)
./claude-bot --version    # print version
./claude-bot --help       # print usage

All env vars prefixed CB_. Can also be set in a .env file (loaded by the binary at runtime).

• Go 1.25+ (for building from source)
• git with identity configured
• gh authenticated (gh auth login)
• claude CLI authenticated

With CB_AUTO_INSTALL=1, missing tools are installed automatically via brew/apt/dnf/npm.

Auto-created on startup: todo, in-progress, done, needs-info, failed, triaged.

CI runs via GitHub Actions using the Taskfile:

• test — task test (13 unit tests)
• release — task release (cross-compiles 6 targets, publishes to GitHub)

Cross-compiled targets: linux/amd64, linux/arm64, darwin/amd64, darwin/arm64, windows/amd64, windows/arm64.