Reference · the tools · sessions

Stop a Claude session now

What it does

Stop one of the owner's sessions on this box at once, whatever it is doing -- for one that has gone wrong or is running too long. Its process and every command it started are killed. It stays in their session list, asleep, with its history: a message (send_to_session, or the owner typing) wakes it, but only after about six minutes, while claude.ai still holds messages for the stopped process. Not the app's stop button, which ends only the turn. To be done with it, archive_session.

What it needs to know

session

Its link or id from list_sessions, or its name.

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 removes something, so Claude confirms with you before calling it.