BettikDocsSign in

Reference · the tools · sessions

read_session

Read-only

Read 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.