claude-pr-autopilot
Open a PR, walk away, come back when it's merge-ready.
A Claude Code marketplace plugin that closes the PR review→fix loop. Cursor reviews your PR (or Copilot / Codex / Claude-self — configurable), Claude reads each review and either fixes the issue or pushes back with reasoning, then pushes the fix and waits for the next round. Stops when all enabled reviewers report success — or hits one of ten independent safety guards.
Install
Prerequisites (one-time)
Required CLIs on your PATH — the skill's pre-flight ABORTs cleanly if any are missing:
| Tool | Windows | macOS | Linux (apt) |
|---|
gh | winget install GitHub.cli | brew install gh | sudo apt install gh |
jq | winget install jqlang.jq | brew install jq | sudo apt install jq |
git | (usually pre-installed) | (usually pre-installed) | (usually pre-installed) |
After install, restart your shell so the binaries are on PATH. Then run gh auth login if you haven't already.
Install the plugin
/plugin marketplace add MarcinSufa/claude-pr-autopilot
/plugin install pr-autopilot@claude-pr-autopilot
Usage (Phase 1)
After creating a PR (via /ship or gh pr create):
/loop /pr-autopilot:step <PR_NUMBER>
The loop runs unattended until success or a safety guard fires. See skills/step/SKILL.md for the full algorithm and docs/DESIGN.md for the architecture spec (8 review rounds; CLEARED by Composer 2.5).
Two rotation modes
- Mode X — an external reviewer (Cursor / Copilot Code Review / Codex) reviews;
Claude applies the fixes. Use when you want human-style review of Claude's work.
- Mode Y — Copilot SWE Agent applies the fixes and pushes commits; Claude reviews
those commits against PUSHBACK.md and approves or flags behavior changes. Use when
you have Copilot SWE Agent and want it to do the fixing.
Set prAutopilot.primaryFixer to auto (default), claude (force X), or
copilotSwe (force Y).
No Cursor Pro? Set copilotSwe.mode: "review-score" — the Copilot SWE Agent reviews
review-only and emits a Readiness: X/5 verdict the loop gates on (just like Cursor's
Score: N/5), with Claude as the fixer. A Cursor-style 1–5 gate using only your Copilot
seat. See reviewers/COPILOT-SETUP.md.
Auto-trigger (v0.3, beta)
Enable the plugin, then /pr-autopilot:allow <owner/repo> (or no arg for the current repo).
After that, creating a PR there (e.g. via /ship) auto-starts autopilot — no manual
/pr-autopilot:step. Draft PRs are skipped. Pause anytime with /pr-autopilot:pause
(re-enable /pr-autopilot:resume).
It's a best-effort in-session nudge (Claude Code hooks can't force actions), and beta
until the live exo-vault dogfood (EVAL scenario 28) confirms the full auto-chain. If the
nudge is ever missed, the manual /pr-autopilot:step <PR#> path still works.
Auto-merge (v0.4, beta)
/pr-autopilot:automerge <owner/repo> (or no arg for the current repo) opts a repo into safe
auto-merge: when the loop reaches SUCCESS on a PR targeting dev, autopilot queues a squash
merge instead of just notifying. It is dev-only, CI-gated, and never merges to
master/main/production (production promotion stays manual via /land-and-deploy).
Default (repo not opted in) = OFF, behavior identical to v0.3.
- Separate allowlist. Auto-merge uses
~/.pr-autopilot/automerge-repos, distinct from v0.3's
allowed-repos. Full hands-off needs BOTH: /pr-autopilot:allow <repo> (auto-start the loop)
AND /pr-autopilot:automerge <repo> (auto-merge at the end).
- Queued ≠ merged.
gh pr merge --auto queues; GitHub completes the merge asynchronously once
required checks and branch protection clear. Autopilot reports "queued", keeps polling, and notifies
again on the actual merge. If a repo doesn't have GitHub auto-merge enabled, it falls back to a direct
squash (safe — CI + reviewers are already green).
- Laptop must stay awake. Like the v0.3 loop, merge-wait ticks use
ScheduleWakeup, so the machine
must stay on until the queued merge completes.
- Shared kill switch.
/pr-autopilot:pause suppresses auto-merge too; /pr-autopilot:resume restores.
Beta until the live exo-vault dogfood (queue → merge → cleanup on a real dev-targeted PR) flips it to GA.
Code knowledge graph awareness (v0.5.3+)
