get-session-info.md

Get session info

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"
  }
}