# kill_session

Source: https://libtmux.org/en/ts/latest/mcp/tools/kill_session/

> Delete tmux state; accepts no command payload. Remove a session. Windows and panes shared with another session remain available there.

MCP is in development

Server behavior and tool contracts may change. Tool availability depends on the server configuration.

Delete tmux state; accepts no command payload. Remove a session. Windows and panes shared with another session remain available there.

[All TypeScript tools](https://libtmux.org/en/ts/latest/mcp/tools/) · [JSON](https://libtmux.org/en/ts/latest/mcp/tools/kill_session.json) · [Source](https://github.com/libtmux/libtmux-ts/blob/b3f338c1a21e614ebf0dd6d55aa36a60db816618/packages/mcp/src/tools/lifecycle.ts#L386)

## Arguments

* `force` optional · boolean

  Allow this to target the pane this server itself was called from, which is otherwise refused. It does not override the refusal to touch a pane a person is watching.

* `session` required · string

  Session id ($1) or name.

## Schemas

The schema defines required fields, nested values, defaults, and validation constraints.

Input schema

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "force": {
      "description": "Allow this to target the pane this server itself was called from, which is otherwise refused. It does not override the refusal to touch a pane a person is watching.",
      "type": "boolean"
    },
    "session": {
      "description": "Session id ($1) or name.",
      "type": "string"
    }
  },
  "required": [
    "session"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "killed": {
      "description": "Stable session id, e.g. $1.",
      "pattern": "^\\$\\d+$",
      "type": "string"
    }
  },
  "required": [
    "killed"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true,
  "readOnlyHint": false
}
```