Reference · the tools · workspaces

Remove a workspace

What it does

Remove a workspace from this box: its container is stopped, and the box forgets it and which account was signed in there. Destructive to running sessions: every session in that workspace ends, and is not woken. Its home stays on disk, still seen read-only from the others; adding a workspace of the same name takes it up again. Main cannot be removed. Ask the owner first, with confirm: true only once they have said yes.

What it needs to know

name

The workspace, as list_workspaces names it.

confirm · optional

Actually remove it. Without this, only say what it would do.

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.