Get window info

get_window_info

get_window_info

readonly tool

Return metadata for a single tmux window (ID, name, layout, dimensions).

Returns:

WindowInfo

Use when you need metadata for a single window (name, index, layout, dimensions, pane count) and you already know the window_id or window_index. Avoids the list_windows + filter dance.

Avoid when you need every window in a session — call list_windows with session_id or iterate via the tmux://sessions/{name}/windows resource.

Side effects: None. Readonly.

Example:

{
  "tool": "get_window_info",
  "arguments": {
    "window_id": "@1"
  }
}

Response:

{
  "window_id": "@1",
  "window_name": "editor",
  "window_index": "1",
  "session_id": "$0",
  "session_name": "dev",
  "pane_count": 2,
  "window_layout": "7f9f,80x24,0,0[80x15,0,0,0,80x8,0,16,1]",
  "window_active": "1",
  "window_width": "80",
  "window_height": "24"
}

Resolve by window_index when only the index is known — requires session_name or session_id to disambiguate:

{
  "tool": "get_window_info",
  "arguments": {
    "window_index": "1",
    "session_name": "dev"
  }
}

Parameters

Parameter	Type	Required	Default	Description
window_id	str	no	—	Window ID (e.g. ‘@1’).
window_index	str	no	—	Window index within the session. Requires session_name or session_id to disambiguate.
session_name	str	no	—	Session name for window_index lookup.
session_id	str	no	—	Session ID for window_index lookup.
socket_name	str	no	—	tmux socket name.