codex-watch-pr

Installation
SKILL.md

Watch a pull request

Use the pull request number in the task, or omit it for the current branch's open pull request. Start one blocking command with a long yield:

bash .agents/skills/codex-watch-pr/scripts/watch-checks.sh <number>

Set the execution yield to at most 30 seconds. If it returns a running session, continue it with write_stdin using empty input and a wait of up to 300 seconds. Keep waiting on that same session. Don't start another watcher or poll gh pr checks between waits. Send a concise progress update at least once a minute while checks remain pending.

The script emits PASS, SKIP, and FAIL events and closes with ALL GREEN, FAILED, TIMEOUT, or NO CHECKS. Exit codes are 0 for green, 1 for failures, and 2 for timeout or absent checks. Timeout and absent checks are inconclusive, not failures. Report the pull request, failed jobs, and printed run links. Invoke codex-fix-pr only when the caller requested remediation.

PR_CHECKS_TIMEOUT and PR_CHECKS_INTERVAL override the script bounds in seconds.

Installs
1
GitHub Stars
122
First Seen
Oct 11, 2026