# list_panes

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

> List tmux panes (terminal multiplexer splits) in a window, session, or server.

MCP is in development

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

List tmux panes (terminal multiplexer splits) in a window, session, or server.

Use for terminal panes — including ‘this pane’, ‘current pane’, ‘split pane’, ‘the bottom shell’ — not editor splits or browser panes. Only searches pane metadata (current command, title, working directory); to search the actual visible terminal text, use [search\_panes](https://libtmux.org/en/py/latest/mcp/tools/search_panes/).

[All Python tools](../) · [JSON](../list_panes.json) · [Source](https://github.com/tmux-python/libtmux-mcp/blob/4daddc0dfca96c43bf521d818bf91564e1434760/src/libtmux_mcp/tools/window_tools.py#L501)

## Arguments

* `filters` optional

  Django-style filters as a dict (e.g. \`\`{"pane\_current\_command\_\_contains": "vim"}\`\`) or as a JSON string. Some MCP clients require the string form.

  Default: `null`.

* `session_id` optional

  Session ID. If given without window params, lists all panes in the session.

  Default: `null`.

* `session_name` optional

  Session name. If given without window params, lists all panes in the session.

  Default: `null`.

* `socket_name` optional

  tmux socket name.

  Default: `null`.

* `window_id` optional

  Window ID (e.g. '@1'). Scopes to a single window.

  Default: `null`.

* `window_index` optional

  Window index within the session. Scopes to a single window.

  Default: `null`.

## Schemas

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