Skip to main content

Follow a run

You can follow a task in three places. The Linear issue shows its status and the agent's messages. The Workflow board shows every task at a glance. The GitHub pull request shows the code and the checks.

In Linear​

  • The status shows the stage: In Progress while the agent implements or fixes, In Review while a review runs, In Human Review while it waits for your approval, In Release while CI is checked and the pull request is merged, and Done.
  • The thread shows what the agent is doing, its questions, and any problem it hit.
  • The queued label and a "⏳ Queued" comment mean the task is waiting to start. The comment shows the reason and its position.

On the Workflow board​

Each task is a ball in the column of its Linear status. Its look tells you what the agent is doing:

StateMeaning
Waiting for an agentIn the queue, or about to start.
An agent is working on itA run is in progress. The card says which agent and for how long.
Needs youWaiting for your answer, your review or your AI access.
Nothing is happeningOpen in Linear, but no agent is working on it.
Didn't work outThe run stopped. The card says why and what is needed.
DoneMerged.

Click a task to open its card. The card shows what changed, how to check it, what is needed from you, and the pull requests, with buttons to Review in GitHub, Answer in Linear or Open in Linear.

In GitHub​

The pull request has the diff, the description of what changed and how to verify it, the CI checks, and the review findings. If your workspace requires human approval, your approving review there is what lets the task continue.

When a task needs you​

You seeDo this
A question in the Linear threadReply in the thread.
In Human ReviewReview the pull request in GitHub. Approve it, or request changes.
"Automatic fix-review paused."The review loop hit its limit. Clarify the issue or fix the pull request, then comment /fix-review or /review.
A stop reason on the card, such as "AI access not connected"Follow What is needed and Open Settings on the card.

See Troubleshooting for every stop reason.