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
queuedlabel 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:
| State | Meaning |
|---|---|
| Waiting for an agent | In the queue, or about to start. |
| An agent is working on it | A run is in progress. The card says which agent and for how long. |
| Needs you | Waiting for your answer, your review or your AI access. |
| Nothing is happening | Open in Linear, but no agent is working on it. |
| Didn't work out | The run stopped. The card says why and what is needed. |
| Done | Merged. |
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 see | Do this |
|---|---|
| A question in the Linear thread | Reply in the thread. |
| In Human Review | Review 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.