Watch a pull request
SkillDev toolsWait for a pull request's checks to settle in one long-running command, then report passed, skipped, and failed jobs with run links. Use whenever the user asks Codex to watch a pull request or wait for CI, and whenever another workflow needs the result before continuing.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Watch a pull request skill
What this skill tells your AI
The instructions your AI receives, as published by tbhb/vale-ai-tells in .claude/skills/codex-watch-pr/SKILL.md and read by ahel’s review.
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.
Signals
- GitHub stars
- 92
- Forks
- 8
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
codex-watch-pr- Source
- github.com/tbhb/vale-ai-tells