Reference · the tools · workspaces
list_workspaces
Read-onlyThe workspaces on this box
What it does
Main and every other workspace on this box: what signs in there (claude or codex), its CPU and memory limits, whether it is running, whether it is signed in, the account it is signed in to when the box has read it, how to ssh into it (the box's ssh address with the workspace's login, wksp-<name>), and its ~/.claude: blank, or the repository and branch it syncs to. A branch one workspace uses is never another's.
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.