Reference · the tools · sessions
read_session
Read-onlyRead what a Claude session said
What it does
What one of the owner's sessions on this box was last asked and what it said back -- its words, not its tool calls -- and whether it is still working. With wait, it waits (up to the seconds given, at most 40) for the session to finish, and for a message send_to_session just sent to be answered rather than returning the turn before. Every answer ends with a cursor: pass it back as after to catch up on everything since -- every message to it and every reply, not only the last.
What it needs to know
- session
- Its link or id from list_sessions, or its name.
- after · optional
- A cursor from an earlier read_session: every turn since then.
- wait · optional
- Seconds to wait for it to finish its turn. Default 0: say what is there now.
- 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.