Get session info

get_session_info

get_session_info

readonly tool

Return metadata for a single tmux session (ID, name, window count, activity).

Returns:

SessionInfo

Use when you need metadata for a single session (ID, name, window count, attachment status, activity timestamp) and you already know its session_id or session_name. Avoids the list_sessions + filter dance.

Avoid when you need every session — call list_sessions or iterate via the tmux://sessions resource.

Side effects: None. Readonly.

Example:

{
  "tool": "get_session_info",
  "arguments": {
    "session_id": "$0"
  }
}

Response:

{
  "session_id": "$0",
  "session_name": "dev",
  "window_count": 3,
  "session_attached": "1",
  "session_created": "1713600000",
  "active_pane_id": "%0"
}

Resolve by name when only the session_name is known:

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

Parameters

Parameter	Type	Required	Default	Description
session_id	str	no	—	Session ID (e.g. ‘$0’).
session_name	str	no	—	Session name.
socket_name	str	no	—	tmux socket name.