Follow an agent while it works
A task's Agent tab lists what its agent does as it does it: its messages, the tools it calls, the commands it runs and the files it changes. New events arrive on their own while the task runs. Read it to see where a task has got to without opening a terminal, or read it after the run to see what happened.
Who can do this: anyone who may view and edit sessions, such as the Org Owner, Org Admin or Project Maintainer role. The events carry the agent's own text, so people without both permissions don't see the tab. It shows once the task has a session that reports its events; older sessions don't, and their tasks have no Agent tab.
-
On the task board, select the task's title. Its page opens beside the board.
-
Select the Agent tab. Agent activity lists the session's events, oldest at the top. Before the first one arrives it says No events yet.
-
Leave the list at the bottom to follow along. Each new event is added there and the list keeps up with it.
-
Scroll up to read an earlier event. The list stops moving so your place holds. Select Jump to latest to go back to the newest event and follow again.
-
A long run shows its newest events only. Select Show 300 earlier events at the top of the list to load more. The number is fewer when fewer are left.
-
A task that ran more than once has a Session list above the events. Pick a session by its start time, agent and model; the one still going says running.
-
To talk to the agent, select Open in chat. The run opens in the console's chat, and the tab then says Following live in the console chat. with Open in chat to bring it back. A task that holds no worktree has no Open in chat.
-
Once the session ends, select Download to save its events as a file. Until then Download is greyed out with the reason beside it, such as Still running.
Related
- Chat with a running task: send the agent a message or stop its turn.
- Find out why a task failed: where to look after a run goes wrong.
- Task page: every tab of the task page.