[docs]
Sessions
The sessions tab lists every Claude Code session on your Mac, from any terminal or editor, as it runs. Open one to see what it’s doing and what it has cost.
Select sessions at the top of the panel, or press ⌘2. The dot and number beside the tab count the running sessions, and turn orange when one is waiting for you.
| [state] | [meaning] |
|---|---|
needs you | Waiting on a permission prompt or a question. |
working | Claude Code is busy with your prompt. |
idle | Open, waiting for your next prompt. |
ended | The session exited. The last 12 from the past 24 hours are listed. |
Sessions are grouped as [needs you], [running] and [last 24 hours]. Each row shows the session’s title, its project and branch, and how long it’s been in its state.
Select a session to open it:
| [section] | [shows] |
|---|---|
[status] | Its state and, when it’s waiting, what it’s waiting for, with allow and deny. |
[summary] | A short summary of the session, written when you ask. |
[usage] | Tokens, cost, prompts, replies, tool calls and cached tokens. |
[tokens] | How the tokens split between cache reads, cache writes, output and input. |
[models] | Each model’s share, when the session used more than one. |
[session] | Folder, branch, length, client, version and session ID. |
[last prompt] | The last thing you asked. |
In the footer, show transcript reveals the session’s transcript in Finder, and copy resume copies a command that reopens the session in a terminal: cd '<folder>' && claude --resume <id>.
Select [summarize] in the [summary] section. Setapp AI reads the session and writes a few lines about what happened. The caption under it names the model and what it cost. Select [ask again] for a fresh one.
To get a summary on every session ended card without asking, turn on summarize ended sessions in settings.
- Archive (⌘E) hides an idle or ended session until it’s active again.
- Move to Trash (⌘⌫) moves an ended session’s transcript to the Trash.
Both are in the session’s header, and in the menu when you Control-click a row. Right after, the footer offers undo (⌘Z) for a few seconds.