Limits at a glance
Correctness caps and the Check Run Agents per-PR limit always have a value; blank fields retain the saved limit. Per-PR limits have a $0.50 minimum. Monthly and CLI limits can be cleared.
Workspace balance and monthly limit
An exhausted balance or reached monthly limit pauses processing. Auto-refill replenishes the balance but does not override the monthly limit. No manual review request bypasses either condition. Processing resumes after a refill, a limit increase, or the next billing period as applicable. Commits and PR events skipped during the pause are not automatically processed afterward.Correctness caps
Correctness estimates cost before running and skips when the proposed review plus recorded spend would exceed the cap. A per-PR skip reports “Per-PR cost limit exceeded (workspace setting)”. The per-PR total includes only GitHub correctness reviews: not Check Run Agents, Approvability, CLI, or other agent usage. The correctness per-PR cap also stops Approvability on that PR, even though Approvability’s own spend does not count toward it. Check Run Agents have their own limit and keep running if their budget permits. Comment@macroscope-app review this PR to bypass correctness per-review and per-PR caps. The workspace monthly limit still applies. See Approvability when reviews are missing.
Check Run Agents per-PR limit
The $100 default is shared by every Check Run Agent on the PR. Once recorded spend reaches it, later automatic runs are created as skipped checks. An explicit mention can bypass it; a GitHub rerun does not. This limit is best effort: no budget is reserved before dispatch. Concurrent agents can all start below the limit and collectively exceed it. Work already running is billed. Per-agent front matter provides narrower controls:
These are separate from the workspace limit. Raising one does not clear another. See configuration and overrides.
CLI review limits
Under CLI Spend Controls, set:
The two workspace fields accept positive amounts. A per-user override of $0 blocks that user; remove it to restore the default.
CLI limits count only CLI reviews, reset each billing period, and apply alongside the workspace balance and monthly limit. The workspace CLI cap blocks everyone once reached, regardless of their personal allowance.
Limits are checked before a review starts. Already-running reviews are not stopped, so concurrent usage can exceed a cap. A declined review costs nothing. Raise the named limit in the CLI error and rerun the review.