# R-ci-watch

> Watch a CI run with live status + emoji dashboard; dump logs on failure; watch auto-merge if CI green + auto-merge enabled + "reviewed" label. Triggers: "watch ci" | "ci watch" | "watch the ci" | "watch run" | "monitor ci".

- Skill: `roxabi/r-ci-watch` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add roxabi/r-ci-watch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/roxabi/r-ci-watch/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Roxabi (https://skillmd.com/u/roxabi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/roxabi/r-ci-watch

---


# CI Watch

Let:
  Φ  := `${CLAUDE_PLUGIN_ROOT}`
  SCR := `${Φ}/scripts/ci-watch.sh`
  R  := OWNER/REPO (auto-detected from git remote)
  AM := auto-merge

Poll a GitHub Actions run, render a live emoji dashboard, dump failed logs on exit, and watch AM if CI is green, AM is enabled on the PR, and the PR has a `reviewed` label.

## Instructions

### 1. Detect repo

```bash
git remote get-url origin
```

Extract R from the URL (handles both HTTPS `https://github.com/OWNER/REPO.git` and SSH `git@github.com:OWNER/REPO.git`).

### 2. Parse arguments

Map `$ARGUMENTS` to script flags:

| Input | Flags passed |
|-------|-------------|
| bare number (e.g. `42`) | `--pr 42` |
| `--run ID` | `--run ID` |
| `--branch NAME` | `--branch NAME` |
| `--pr NUMBER` | `--pr NUMBER` |
| `--workflow NAME` | `--workflow NAME` |
| `--interval N` | `--interval N` |
| (none) | (omit — script auto-detects branch + `ci.yml` workflow) |

### 3. Run the script

```bash
bash SCR --repo R [flags]
```

Use a 600000ms timeout (10 min). Stream output directly — do not buffer.

### 4. Report result

- Exit 0 → confirm run passed (and, if AM was watched, the PR merged).
- Exit 1 → confirm run failed; note that failed logs were printed above.
- Exit 2 → confirm run was cancelled.
- Exit 4 → **CI passed but the PR did not merge** (closed / conflicts / auto-merge disabled / watch timed out). ¬a CI failure — do not offer Retry-CI. Route to a merge follow-up: rebase, resolve conflicts, or re-enable auto-merge.
- Non-zero (other) → report the exit code and raw conclusion.

### 5. Watch auto-merge (if applicable)

AM_eligible(pr) ⟺ PR# known ∧ `autoMergeRequest` ¬null ∧ label `reviewed` ∈ PR.

¬AM_eligible → exit after reporting CI passed.

∀ AM_eligible: enter merge-wait loop (live spinner) → exit once merged (0) ∨ green-CI-unmerged (4).
- `MERGED` → confirm PR merged automatically (exit 0).
- `CLOSED` / `DIRTY` (conflicts) / auto-merge disabled / watch timeout → exit 4 (see §4).
- `BEHIND` / `BLOCKED` / `UNSTABLE` → transient, keep polling (¬terminal).

Timeout: the loop self-bounds at `MERGE_WAIT_TIMEOUT` (script, 15 min) → graceful exit 4. This is only reachable if the **Bash timeout you pass exceeds CI-watch time + that bound** — when a PR is expected to auto-merge, allow a Bash timeout ≥ 20 min so the script's exit 4 fires instead of a hard SIGKILL.

## Chain Position

- **Phase:** Verify
- **Predecessor:** `/R-pr` (via `/R-dev`) · or `reviewed` label step (via `/R-ship`)
- **Successor:** `/R-validate` (via `/R-dev`) · or `/R-cleanup` (via `/R-ship` after merge)
- **Class:** adv (continuous flow, no gate)

## Task Integration

- `/R-dev` owns the dev-pipeline task lifecycle externally
- This skill does NOT update its own dev-pipeline task
- Sub-tasks created: none
- Follow-up: CI failure → `/R-dev` may create a re-run / fix follow-up task

## Exit

- **CI green via `/R-dev`:** return control silently. ¬write summary. ¬ask user. ¬announce `/R-validate`. `/R-dev` re-scans and advances.
- **CI green standalone:** print one line: `CI passed. Next: /R-validate`. Stop.
- **CI failed/cancelled (exit 1/2):** return error. `/R-dev` presents Retry | Skip | Abort (or creates a follow-up fix task depending on failure type).
- **CI green but unmerged (exit 4):** ¬a CI failure — report the merge blocker (conflicts / closed / auto-merge off / timeout) and route to rebase / resolve / re-enable, ¬Retry-CI.

$ARGUMENTS