Kill session

kill_session

kill_session
destructive tool

Kill a tmux session.

Returns:

str

Use when you’re done with a workspace and want to clean up. Kills all windows and panes in the session.

Avoid when you only want to close one window — use kill_window.

Side effects: Destroys the session and all its contents. Not reversible.

Example:

{
  "tool": "kill_session",
  "arguments": {
    "session_name": "old-workspace"
  }
}

Response (string):

Session killed: old-workspace

Parameters

Parameter

Type

Required

Default

Description

session_name

str

no

Session name to look up.

session_id

str

no

Session ID (e.g. ‘$1’) to look up.

socket_name

str

no

tmux socket name. Defaults to LIBTMUX_SOCKET env var.