# reviewloop

> An open-source, self-hosted PR reviewer that runs on the Claude Code
> subscription you already have. A GitHub webhook pushes `pull_request` events
> into a Convex deployment *you* own; a local worker subscribes over the Convex
> websocket and reviews each PR the moment it opens or is pushed to, by spawning
> `claude -p` in a throwaway clone. Nothing is hosted by anyone else — your
> machine, your Convex project, your GitHub webhooks.

reviewloop is installed *by your coding agent*. Paste this into Claude Code,
Codex, or any agent that can fetch a URL and run commands:

> Fetch https://raw.githubusercontent.com/fagnersales/reviewloop/master/INSTALL.md
> and follow it to install reviewloop for me.

Once installed you get three CLIs on your PATH — `reviewloop-await` (block on a
review over the websocket, verdict in the exit code), `reviewloop-ack` (claim a
review you're fixing), and `reviewloop-suggest` (file out-of-scope follow-ups
into the console's inbox) — plus the agent skills below.

## Agent skills

- [reviewloop-feature](https://raw.githubusercontent.com/fagnersales/reviewloop/master/.claude/skills/reviewloop-feature/SKILL.md): **The one to install first.** The full build→review→fix loop as a single skill: build a feature idea in an isolated git worktree, open a PR, then *block* on the reviewloop review via `reviewloop-await` in the background — never polling GitHub, never asking "is it done yet?". A clean review stops and reports; P0/P1 blockers are fixed and re-reviewed until clean. It also covers making UI work visible (mock it, screenshot it), `Closes #N` issue linkage, merge-and-clean-up, and flushing out-of-scope findings to the follow-ups inbox. Drop it in `~/.claude/skills/reviewloop-feature/SKILL.md` (global, works in every repo) and invoke it with `/reviewloop-feature <what you want to build>`. This is also the skill the autonomous solver spawns headlessly.
- [reviewloop-review](https://raw.githubusercontent.com/fagnersales/reviewloop/master/.claude/skills/reviewloop-review/SKILL.md): The review itself — a Greptile-style pass that investigates beyond the diff (callers, callees, schema, git history) and posts one COMMENT review with severity-badged inline findings and a summary. The worker passes this inline, so watched repos don't need it checked in.
- [onboard-repo](https://raw.githubusercontent.com/fagnersales/reviewloop/master/.claude/skills/onboard-repo/SKILL.md): Add a repo to reviewloop — webhook + watch row, both layers.
- [update-reviewloop](https://raw.githubusercontent.com/fagnersales/reviewloop/master/.claude/skills/update-reviewloop/SKILL.md): Pull the latest upstream version, push Convex functions, restart the worker.

## Docs

- [README](https://raw.githubusercontent.com/fagnersales/reviewloop/master/README.md): What it is, the architecture, the workers, the autonomous issue→PR solver.
- [INSTALL](https://raw.githubusercontent.com/fagnersales/reviewloop/master/INSTALL.md): The idempotent install playbook, written for an agent to execute.
- [UPDATE](https://raw.githubusercontent.com/fagnersales/reviewloop/master/UPDATE.md): Updating an existing install, including forks.
- [CONTEXT](https://raw.githubusercontent.com/fagnersales/reviewloop/master/CONTEXT.md): Domain glossary — the vocabulary the console and workers use.

## Optional

- [Source](https://github.com/fagnersales/reviewloop): MIT-licensed. Convex backend, Node workers, Vite/React console.
- [Homepage](https://reviewloop.fagner.ink): Overview and screenshots.