list_panes

Rust

List every pane on the server. Inspect tmux metadata; accepts no client-supplied executable input.

Arguments

This tool has no top-level named arguments. Consult its schema below.

Schemas

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

Input schema

{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}

Output schema

{
  "$defs": {
    "PaneView": {
      "description": "One pane, as the protocol sees it.",
      "properties": {
        "active": {
          "description": "Whether this is the window's active pane.",
          "type": "boolean"
        },
        "caller": {
          "$ref": "#/$defs/Relation",
          "description": "Whether this is the pane the MCP server itself runs in.\n\n`self` only on a confirmed match of both socket and pane id; `other`\nfor every pane that is not, including one this crate cannot prove\neither way; `unknown` when the server is not running inside tmux, so\nthe question has no answer."
        },
        "command": {
          "description": "The command currently running.",
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "description": "The `%`-prefixed tmux identity.",
          "type": "string"
        },
        "path": {
          "description": "The pane's working directory.",
          "type": [
            "string",
            "null"
          ]
        },
        "window_id": {
          "description": "The window that contains the pane.",
          "type": "string"
        }
      },
      "required": [
        "id",
        "window_id",
        "active",
        "caller"
      ],
      "type": "object"
    },
    "Relation": {
      "description": "How a pane relates to the process answering the request.\n\nThree values rather than a boolean, because \"not the caller's pane\" and\n\"there is no caller\" are different answers and an agent acts differently on\neach.",
      "oneOf": [
        {
          "const": "unknown",
          "description": "This process is not running inside tmux, so no pane is its own.",
          "type": "string"
        },
        {
          "const": "self",
          "description": "Confirmed: the same tmux server, and the same pane.",
          "type": "string"
        },
        {
          "const": "other",
          "description": "Some other pane, or a pane this crate cannot prove is the caller's.",
          "type": "string"
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "panes": {
      "description": "The panes, in tmux's own order.",
      "items": {
        "$ref": "#/$defs/PaneView"
      },
      "type": "array"
    }
  },
  "required": [
    "panes"
  ],
  "type": "object"
}

Tool annotations

{
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false,
  "readOnlyHint": true,
  "title": "List Panes"
}