agent-code-review
PR review queue and scheduler for AI agents
- Language
- Go
- Version
- 0.31.1
- License
- PolyForm Perimeter 1.0.0
- Category
- CLI Tool
A review daemon that finds candidate pull requests across your repos with the GitHub CLI, keeps a DuckDB-backed queue that survives restarts, and reviews each one by handing an assembled prompt to a pluggable engine — Codex or Claude Code. Eligibility holds keep a tight cadence cheap: only genuinely actionable work spends tokens. Ships a dashboard you can expose over Tailscale.
Features
Deterministic discovery — candidate PRs found via gh on their own cadence, never involving the LLM; approved PRs are skipped
Eligibility holds — a quiet period stops reviews mid-rebase, a re-review cooldown gives the author room to respond to the last one
Durable DuckDB queue — candidates, positions and review history survive restarts, which is what powers Refreshed detection
Pluggable engine — codex or claude, same verdict contract and same review log, so switching is a one-key config change
Live review logs — the engine tees into the workspace, so an in-flight review streams via queue log -f or the dashboard
Usage floors — the loop pauses when the engine's rate-limit window drops below a threshold, and resumes when it refills
Every engine metered side by side — see whether the one you are not using has more headroom before switching
Per-review spend recorded — token counts and API-rate cost, so a budget comes from your own data rather than a guess
Author groups as policy — ignore, comment or approve, per repo, each carrying its own engine and extra instruction
Serve with a dashboard — always-on daemon, optionally on your tailnet; most config reloads live within ~30s
Everything is config — repos, groups, thresholds, cadence, prompts and rules; no handles or repos hardcoded
doctor checks every runtime assumption at once, and serve runs the same checks at boot
Install
Homebrew
$ brew install shhac/tap/agent-code-review AI Agent Skill
$ npx skills add shhac/agent-skills --skill agent-code-review --global GitHub Release (macOS)
$ curl -L https://github.com/shhac/agent-code-review/releases/latest/download/agent-code-review-darwin-arm64.tar.gz | tar xz Go Install
$ go install github.com/shhac/agent-code-review/cmd/agent-code-review@latest Build from Source
$ git clone https://github.com/shhac/agent-code-review.git && cd agent-code-review && make build Getting Started
agent-code-review assumes only gh (authenticated), the duckdb CLI, and whichever engine you select — codex or claude, already authenticated. It never handles engine credentials. Run doctor to check all of that at once before your first cycle.
01 · Write the starter config
$ agent-code-review config init Repos, author groups, thresholds, cadence, prompts and rules all live in config.json.
02 · Add repos and roster the authors
$ agent-code-review repos add your-org/your-repo Then place people in groups with authors set. A group is a complete review policy: ignore, comment or approve.
03 · Set your prompts and dials
$ agent-code-review config set candidates.rereview_cooldown 2h Every command group has a usage subcommand with full docs and examples — repos usage, authors usage, prompts usage, config usage, queue usage.
04 · Kick a single cycle, then run the daemon
$ agent-code-review serve --http :8330 --tailscale serve Try agent-code-review run --once first. serve adds the dashboard and can expose it on your tailnet.
Usage
$ agent-code-review doctor $ agent-code-review queue ls $ agent-code-review queue promote your-org/your-repo 1234 $ agent-code-review queue log your-org/your-repo 1234 -f $ agent-code-review authors set your-org/your-repo some-handle approver $ agent-code-review prompts preview --author some-handle $ agent-code-review run --once