pr-watch

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.

Jump to install

Repository: SethGammon/Citadel
Last source activity: June 11, 2026 at 21:28
Detected SKILL.md language: English
Stars: 903
Forks: 83

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/SethGammon/Citadel --skill pr-watch

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

5 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

research

Focused research investigations. Converts questions into structured findings with confidence levels and source citations. Single agent by default; with --parallel (or when the question decomposes into 3+ independent angles) it spawns scout agents whose findings are compressed into a unified brief. Does not make decisions; produces information that informs the next step.

2026-08-10

Unified router that auto-routes user intent to the right direct action, skill, orchestrator, or explicit Operation Control plan. Classifies input by scope, complexity, persistence needs, and parallelism, then dispatches to the cheapest path that can handle it: direct command, skill, marshal, archon, or fleet. Single entry point for all work.

2026-08-09

setup

First-run experience for the harness. Three modes: Recommended (guided, ~3 min), Full Tour (guided + skill walkthrough, ~8 min), and Express (zero questions, ~30 sec). Installs hooks first, detects stack, configures harness.json, runs a live demo on real code, and prints a reference card.

2026-08-09

View all from this repository

name	pr-watch
license	MIT
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.
user-invocable	true
auto-trigger	false
trigger_keywords	["watch pr","watch ci","monitor pr","fix ci","ci failing","pr failing","auto-fix","auto fix pr","pr is red","checks failing"]
effort	high
last-updated	"2026-03-26T00:00:00.000Z"

/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:

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:

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

Input	Source	Required
PR number	Argument (e.g., `/pr-watch 42`)

Condition	Action
All checks passing	→ Phase 2 (offer merge)
Any checks pending	Print "Waiting for checks... (N pending)". Wait 60 seconds. Loop.
Any checks failed	→ Step 1.3 (investigate and fix)
PR closed or merged	Exit. Print "PR # is already closed/merged."

Failure class	Signal in logs	Fix strategy
TypeScript errors	`error TS`	Fix the specific TS errors in named files
Test failures	`FAIL`, assertion errors, `Expected` vs `Received`	Fix assertion or the code under test
Lint errors	rule names, `@typescript-eslint/`, `eslint`	Fix the specific violations
Build errors	`Cannot find module`, `SyntaxError`, missing exports	Resolve imports, configs
Missing env / secrets	`undefined`, auth failures in setup steps	Surface to user — not fixable from code
Infrastructure failure	Step itself failed (e.g., `actions/checkout`), network	Surface to user — not fixable from code

pr-watch

Install options

Review the source files

/pr-watch — Local PR Auto-fix

When to Use

Cloud Alternative

Inputs

/pr-watch — Local PR Auto-fix

When to Use

Cloud Alternative

Inputs

Execution Protocol

Phase 0 — Setup

Phase 1 — Watch Loop

Step 1.1 — Fetch CI status

Step 1.2 — Evaluate status

Step 1.3 — Fix failing checks

Phase 2 — Merge Offer

Circuit Breaker Rules

Contextual Gates

Quality Gates

Anti-Patterns — Do NOT

Fringe Cases

Exit Protocol

pr-watch

Source facts

Install options

Review the source files

More from this repository

More from this repository

/pr-watch — Local PR Auto-fix

When to Use

Cloud Alternative

Inputs

/pr-watch — Local PR Auto-fix

When to Use

Cloud Alternative

Inputs

Execution Protocol

Phase 0 — Setup

Phase 1 — Watch Loop

Step 1.1 — Fetch CI status

Step 1.2 — Evaluate status

Step 1.3 — Fix failing checks

Phase 2 — Merge Offer

Circuit Breaker Rules

Contextual Gates

Quality Gates

Anti-Patterns — Do NOT

Fringe Cases

Exit Protocol