# PR Watch

Local PR watcher.

- Repository: https://github.com/SethGammon/Citadel (927 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add SethGammon/Citadel --skill pr-watch -g -a claude-code -y`
Codex: `npx skills add SethGammon/Citadel --skill pr-watch -g -a codex -y`
Cursor: `npx skills add SethGammon/Citadel --skill pr-watch -g -a cursor -y`
Gemini CLI: `npx skills add SethGammon/Citadel --skill pr-watch -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add SethGammon/Citadel`

## Description

Local PR watcher. Monitors CI status, automatically fixes failing checks by reading failure logs and applying targeted fixes, then optionally merges when all checks pass. Local CLI analog to Claude Code's cloud auto-fix feature.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# /pr-watch, Local PR Auto-fix

You are the PR watcher. You monitor a pull request's CI status, fix failing checks
by reading failure logs and applying targeted fixes, and optionally merge when green.

This is the local CLI analog to Claude Code's cloud auto-fix feature. Use it when
you want CI watch/fix behavior from the terminal without switching to web or mobile.

## When to Use

**Don't use when:** monitoring local file changes (use /watch); reviewing code quality (use /review); triaging multiple issues at once (use /triage).

- `/pr-watch`, watch the PR for the current branch
- `/pr-watch 42`, watch PR #42 specifically
- After `/triage` creates a fix PR and you want to stay in the terminal
- When you don't have the Claude GitHub App installed for cloud auto-fix

## Cloud Alternative

If you have the Claude GitHub App installed, use cloud auto-fix in Claude Code web or mobile, it survives machine sleep. Toggle **Auto fix** ON in the PR view. Use `/pr-watch` for in-terminal sessions.

In Codex, prefer the native PR review and automation surfaces when they fit:

```bash
node scripts/codex-pr-review.js plan --repo <owner/repo> --pr <number> --risk medium --write
node scripts/codex-automation.js plan --type pr-watch --command "/pr-watch <number>" --cadence "every 15 minutes" --write
```

Use `@codex review` for GitHub-visible review findings, then keep Citadel responsible for local verification, CI log fixes, merge readiness, and `.planning/pr-review/` state.

If `.planning/` does not exist, create it before writing PR review or automation state.

When Codex has already reviewed the PR, ingest its review output before polling or merging:

```bash
node scripts/codex-review-fetch.js --repo <owner/repo> --pr <number> --write
```

Use `--file <review-comments.json>` with the same script when working from exported/offline review data.

## Inputs

The rest: https://github.com/SethGammon/Citadel/blob/HEAD/skills/pr-watch/SKILL.md