libtmux_mcp.tools.window_tools.list_panes
-
List tmux panes (terminal multiplexer splits) in a window, session, or server.
Description#
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.
- Parameters
-
-
session_name(str | None) # – Session name. If given without window params, lists all panes in the session. -
session_id(str | None) # – Session ID. If given without window params, lists all panes in the session. -
window_id(str | None) # – Window ID (e.g. '@1'). Scopes to a single window. -
window_index(str | None) # – Window index within the session. Scopes to a single window. -
socket_name(str | None) # – tmux socket name. -
filters(dict[str, str] | str | None) # – 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.
-
- Returns
-
list[PaneInfo] List of serialized pane objects.