Reference · the tools · boxes
destroy_box
What it does
Destroy one of your boxes: the machine and every environment on it. Your templates stay. Cannot be undone. Refused from a session running on that box -- it would end the session -- use the dashboard or a session elsewhere. Confirm with the user first, then pass the box name back as `confirm`. Ask whether to keep its SSH keys, env vars and Claude settings as box settings first (keep_settings_as): they are lost with the box otherwise.
What it needs to know
- box
- Which box to destroy, by name.
- confirm
- The box name, typed again, to confirm.
- keep_settings_as · optional
- Keep its SSH keys, env vars and Claude settings first, as your box settings of this name (replacing any of that name). Optional.
- 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.