Find the session behind a branch or slot
You have a pull request and want to know which agent run wrote it, or a worktree slot that is acting up and want to know what last ran in it. Audit's Sessions tab finds the run from the branch name, the slot or a session id, without knowing the task first.
Who can do this: viewing Sessions needs a role that can view sessions (any project role, or Org Admin or Org Owner), and your plan must include Session transcripts. Without the plan, Sessions shows Not on your plan in place of the list. Downloading a transcript needs a role that can download transcripts: Project Maintainer, Org Admin or Org Owner.
- Copy what you have: the branch name from the pull request, the slot's name from the task's Details tab or from Worktrees, or a session id.
- In the sidebar, select Audit, then the Sessions tab.
- Set Window to how far back the run could be, such as Last 30 days or All time. It starts on Last 24 hours, or on All time when you open Sessions from a link that already carries a search or a task, such as a run's link.
- Paste the text into Search (the box reads name, id, slot). Hover the box for everything it looks in: Searches name, session id, row id, slot, branch and holder. The list narrows as you type.
- If the list reads No sessions match these filters, look at the Wider windows: line under it and select a count to switch to that window. Clear filters removes the search and the other filters, and keeps Window.
- Hover the mark beside a session's name to read its notes. Slot: names the slot it ran in, and Account: the model account it ran on, when one was recorded and you can see it. Started … · Ended … gives the exact times.
- Select ⋯ on the row, then Open task #…, to open the task that asked for the work.
- Optional: if your role can download transcripts, select ⋯, then Download, to read what the agent did and said. Select Download again in the Transcript redaction is best effort dialog. Treat the file as if it still holds credentials and customer data.
- Clear the Search box to see every session again.
The search and filters are part of the page's address, so you can copy the link and share the same view.
Related
- Follow a task's sessions — every run of one task, once you know the task.
- See what ran on a node — narrow Sessions to one machine instead of one branch or slot.
- How worktrees work — what a slot is and how a task gets one.
- Sessions — every filter, column and note on the screen.