List panes

list_panes

list_panes

readonly tool

List panes in a tmux window, session, or across the entire server.

Returns:

list[PaneInfo]

Use when you need to discover which panes exist in a window before sending keys or capturing output.

Side effects: None. Readonly.

Example:

{
  "tool": "list_panes",
  "arguments": {
    "session_name": "dev"
  }
}

Response:

[
  {
    "pane_id": "%0",
    "pane_index": "0",
    "pane_width": "80",
    "pane_height": "15",
    "pane_current_command": "zsh",
    "pane_current_path": "/home/user/myproject",
    "pane_pid": "12345",
    "pane_title": "build",
    "pane_active": "1",
    "window_id": "@0",
    "session_id": "$0",
    "is_caller": false
  },
  {
    "pane_id": "%1",
    "pane_index": "1",
    "pane_width": "80",
    "pane_height": "8",
    "pane_current_command": "zsh",
    "pane_current_path": "/home/user/myproject",
    "pane_pid": "12400",
    "pane_title": "",
    "pane_active": "0",
    "window_id": "@0",
    "session_id": "$0",
    "is_caller": false
  }
]

Parameters

Parameter	Type	Required	Default	Description
session_name	str	no	—	Session name. If given without window params, lists all panes in the session.
session_id	str	no	—	Session ID. If given without window params, lists all panes in the session.
window_id	str	no	—	Window ID (e.g. ‘@1’). Scopes to a single window.
window_index	str	no	—	Window index within the session. Scopes to a single window.
socket_name	str	no	—	tmux socket name.
filters	dict[str, str] | str	no	—	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.

Act