stella monitor
Watch CI for a branch or PR and fix failures until it is fully green.
Watch CI for a branch or pull request and fix failures until the pipeline is fully green.
Synopsis
stella monitor [target] [global flags]The optional target is a branch or PR to watch. When omitted, it defaults to main.
What it does
stella monitor uses the ci_status tool to watch the CI runs for the given target. It works iteratively — inspecting each failure, fixing its root cause, then committing and pushing the fix before re-checking — and treats the job as a goal that is met only when the latest CI run is all-green.
Under the hood, monitor is goal mode with a fixed CI objective, so it inherits goal mode's mechanics wholesale: a cross-family judge confirms the green run from evidence, and the same backstops apply — the default hard cap of 8 judged rounds (it stops there and reports the goal as not met even if CI is still red), the --budget limit, and a worker-turn abort. It is not an unbounded daemon; re-run it to keep going.
monitor commits and pushes its fixes to the target branch between CI runs. Because the default target is main, a bare stella monitor will push commits directly to main — pass a feature branch or PR as the target if that is not what you want.
stella monitor relies on the ci_status tool, which reads CI state through the GitHub gh CLI — so gh must be installed and authenticated on your PATH. See Tools for the full built-in tool list.
Flags
stella monitor takes the global flags. The most relevant ones:
| Flag | Why it matters here |
|---|---|
--model <provider/model_id> | Pin the worker model used to diagnose and fix failures. |
--budget <usd> | Cap total spend while it works across CI runs. |
monitor is an interactive mode and always renders human-readable text; it does not honor --output-format.
Examples
Watch the default main branch and fix failures until green:
stella monitorWatch a specific branch:
stella monitor feature/payments-refactorWatch a pull request and cap total spend:
stella --budget 5.00 monitor "#128"