GithubClaw

GithubClaw

**Near-autonomous AI agents that manage your open-source project end-to-end.**

GithubClaw treats GitHub as the single source of truth. A webhook server receives events, an orchestrator classifies them, and specialized AI agents handle everything from triaging issues to writing code to reviewing PRs — all visible through normal GitHub workflows. You stay in control through branch protection, mission-level configuration, and fully editable agent prompts.

Quick Start

cargo install --path .            # install from the current checkout
# or, after crates.io release:
# cargo install githubclaw

cd /path/to/your-repo
githubclaw init                   # initialize ~/.githubclaw for this repo

Then follow the setup steps below.

1. macOS only: grant Full Disk Access to your terminal app

The most reliable way to run GithubClaw on macOS is to grant **Full Disk Access** to Terminal or iTerm, then use `githubclaw start`.

On macOS, `githubclaw start` uses a tmux-backed `githubclaw serve` session behind the scenes instead of relying on `launchd` as the default runtime.

Recommended setup:

1. In System Settings -> Privacy & Security -> Full Disk Access, enable access for Terminal or iTerm.
2. Keep managed repositories and worktrees in an unprotected path such as ~/Projects when possible.
3. Start the server:

githubclaw start

If you use the project `Makefile`, the equivalent is still:

make start

Useful tmux commands:

tmux attach -t githubclaw
tmux ls

If you want to start the tmux session explicitly yourself, you can still run:

make serve-tmux

2. Edit your project mission

Open `~/.githubclaw/repos//VALUE.md` and describe what the project is about. Every agent reads this to align decisions with your goals.

3. Set up a public tunnel

GithubClaw needs a public URL so GitHub can deliver webhooks to your local machine. Pick any tunnel service:

# Option A: Clo