Reference · the tools · sessions
list_sessions
Read-onlyClaude sessions on this box
What it does
The owner's Claude sessions on this box that they can open on claude.ai or in the Claude app: each one's name, link, directory, and whether it is working, idle, asleep, or restarting. Asleep means no process right now -- it is not ended, and wake_session brings it back with its history. A session the owner archived is not listed. Restarting means the workbench restarted under it and the box is waking it itself, by the time shown. On a box with more than one workspace, every workspace's sessions are listed and each says which it is in. Covers one box; for the others, call it with each box from list_boxes.
What it needs to know
- box · optional
- Which box: its name and account, "home.frank" or "jordan.northwind", or just "home" when only one of your boxes is called that. Omit it for your current box (switch_box changes it; list_boxes says which it is).
- session_box · optional
- The box this session runs on, if it runs on one of yours: its name, as the on-box instructions give it ("frankh90.hemlane"). With it, a call that names no box is checked against your current box.
Where it lands
On one of your boxes: the one named in box, or your default box when none is named. It changes nothing.