# list_panes

Source: https://libtmux.org/en/csharp/latest/mcp/tools/list_panes/

> Inspect tmux metadata; accepts no client-supplied executable input. List tmux panes, optionally within one session or window. Filter for isCaller=true to answer 'which pane am I in?', which finds one only when this server drives the caller's own socket — get_server_info says whose socket that is. This reads sizes and running commands, not terminal text — for that use search_panes.

MCP is in development

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

Inspect tmux metadata; accepts no client-supplied executable input. List tmux panes, optionally within one session or window. Filter for isCaller=true to answer ‘which pane am I in?’, which finds one only when this server drives the caller’s own socket — [get_server_info](https://libtmux.org/en/csharp/latest/mcp/tools/get_server_info/) says whose socket that is. This reads sizes and running commands, not terminal text — for that use [search_panes](https://libtmux.org/en/csharp/latest/mcp/tools/search_panes/).

[All C# tools](https://libtmux.org/en/csharp/latest/mcp/tools/) · [JSON](https://libtmux.org/en/csharp/latest/mcp/tools/list_panes.json) · [Source](https://github.com/libtmux/libtmux-dotnet/blob/cf34b255c896d19a97e7d7fabea58609c916012d/src/LibTmux.Mcp/Policy/CapabilityModel.cs#L571)

## Arguments

* `session` optional · string | null

  A session id or name. Omit for every session.

  Default: `null`.

* `windowId` optional · string | null

  A window id. Omit for every window.

  Default: `null`.

## Schemas

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

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "session": {
      "default": null,
      "description": "A session id or name. Omit for every session.",
      "type": [
        "string",
        "null"
      ]
    },
    "windowId": {
      "default": null,
      "description": "A window id. Omit for every window.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}
```

Output schema

```json
{
  "properties": {
    "result": {
      "items": {
        "properties": {
          "active": {
            "type": "boolean"
          },
          "currentCommand": {
            "type": [
              "string",
              "null"
            ]
          },
          "currentPath": {
            "type": [
              "string",
              "null"
            ]
          },
          "dead": {
            "type": "boolean"
          },
          "height": {
            "type": "integer"
          },
          "historyLimit": {
            "type": [
              "integer",
              "null"
            ]
          },
          "historySize": {
            "type": [
              "integer",
              "null"
            ]
          },
          "index": {
            "type": "integer"
          },
          "inMode": {
            "type": "boolean"
          },
          "isCaller": {
            "type": "boolean"
          },
          "paneId": {
            "type": "string"
          },
          "pid": {
            "type": [
              "integer",
              "null"
            ]
          },
          "sessionId": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "width": {
            "type": "integer"
          },
          "windowId": {
            "type": "string"
          },
          "zoomed": {
            "type": "boolean"
          }
        },
        "required": [
          "paneId",
          "windowId",
          "sessionId",
          "index",
          "width",
          "height",
          "title",
          "active",
          "dead",
          "zoomed",
          "inMode",
          "currentCommand",
          "currentPath",
          "pid",
          "historySize",
          "historyLimit",
          "isCaller"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}
```

Tool annotations

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