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 latest run 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 watches CI runs for the target you give it. It uses whatever CI tool your session has available: a workspace custom tool or an MCP server. It works step by step: it looks at each failure, fixes the root cause, then commits and pushes the fix before checking again. It only considers the job done when the latest CI run is fully green.
Behind the scenes, monitor runs on goal mode with a fixed goal: get CI green. That means it uses goal mode's safety limits too. A separate verifier checks the evidence that CI is actually green. There's a hard cap of 8 rounds by default: if CI is still red after 8 rounds, stella stops and reports the goal as not met. The --spend-limit cap and a worker-turn abort also apply. monitor does not run forever. If it stops before CI is green, run it again to keep going.
monitor commits and pushes its fixes straight to the target branch between CI runs. Since the
default target is main, running stella monitor with no arguments pushes commits directly to
main. If that's not what you want, pass a feature branch or PR as the target.
stella monitor needs some way to read CI state. This is usually a GitHub MCP server,
or a custom tool that wraps the gh CLI. Without one of these,
the agent can't see the runs it's supposed to fix.
Flags
stella monitor takes the global flags. The most relevant ones:
--model <provider/model_id>Pin the worker model used to diagnose and fix failures.
--spend-limit <usd>Cap total spend while it works across CI runs.
monitor is an interactive mode. It always shows plain, human-readable text, and it does not
accept --output-format. Passing that flag causes a parse error.
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 --spend-limit 5.00 monitor "#128"