Runs need the Pro plan or higher, and the organization’s AI processing must be on. Where runs are not enabled the run page and Assign to Zespan are not shown.
What starts a run
A run starts on its own when an issue is all of these:- Failed (a Degraded issue never starts a run on its own)
- proven, not likely
- open, with at least 3 occurrences
- seen in the last 24 hours, with its newest occurrence still inside your retention window
Degraded issues wait for you. A Degraded issue never starts a run by itself. It shows Assign to Zespan, and a suggestion that was already written for it stays visible.
What a run may and may not do
A run may read this project’s traces, spans, findings, scores, changes and issues, work out a cause, run proofs that touch nothing live, write drafts, add items to Needs you, and write its own rows in Activity. A run never applies anything (a policy, guardrail, alert rule, prompt version, SDK setting or cost action), changes an issue’s state (no resolve, dismiss or escalate), runs your tools, or lets text from a trace choose what it does. It reports a cause only when it can ground it in what it read. “Not checked” is a valid result.The limits
Limits are counts. Every one is checked before the work it limits.
When the day’s automatic runs are used, the issue says
Not investigated with the time the limit resets, shown in your own time zone. Run now starts a run by hand where there is room, and owners and admins can change the limit. When several Failed issues wait for tomorrow, Home says how many.
Change the limits
The automatic-run limits live in two cards. Both show counts, never money, and both are shown only where runs are on.
Press Save. The result appears in a line under the form, and focus moves to it. If the count could not be read, the card says
Today: not available rather than showing 0. A limit of 0 turns automatic runs off for that project or organization. A run starts only when both the project’s limit and the organization’s have room. A run you start yourself is not counted. When an issue says Not investigated because the limit is reached, its Change limit link goes to the matching card.
The run page
Open a run from the issue, or from the top-bar chip while one is running.1
Read the head
The head shows the run’s title, its status (
Queued, Running, Paused, Done, Stopped at limit, Stopped or Failed), how many model calls it has used, and why it started.2
Follow the steps
The ledger has one row per step: read the issue, pick sample runs, read where each run breaks, check recorded changes and findings, work out the cause, run zero-spend proofs, write drafts. Each row shows what it looked at, a count, its state and how long it took. Only the step that is running opens its log lines.
3
Review the drafts
The drafts panel reads Drafting until the run finishes. Then each draft appears with a link to Needs you, where you decide. A run never applies a draft.
Step 5 of 7 running: Worked out the cause, when the running step changes, and Run Done. when the status does. It says nothing on a refresh that changes neither, and nothing once the run has ended.
Pause and Stop
- Pause takes effect before the next step. A paused run keeps the project’s one run slot and its time does not count against the 10 minutes. After 30 minutes paused it stops, with the reason “paused too long”. Resume continues at the first unfinished step.
- Stop asks first:
Stop this run?. Drafts whose evidence is complete are kept and marked partial.
Stopped at limit
When a run reaches its per-run limit it stops with the status Stopped at limit and the lineStopped · run limit reached after step 5 of 7. Drafts whose evidence is complete are kept and marked, for example, Partial · cause not confirmed · 3 of 5 sample runs read. A Not checked list names what was skipped.
Continue run
Continue run appears only on a run that stopped at its limit. It starts one new linked run at the first unfinished step, with its own per-run limits and the same daily limits. The page then shows both runs as one ledger, with a divider readingContinued by <initials> at <time>. People without access to the audit log see team in place of initials. A run can be continued once.
Next steps
- Issues: Assign to Zespan and where a run starts
- Needs you: the drafts a run leaves for you
- Home: the last run, and issues waiting for the limit
- ZespanPilot: what the agent may and may not do
- Activity: the rows a run writes

