get_session_timeline
Access a session's event timeline in chronological order. Supports getting the last events with 'tail' and paginating with 'offset'.
Instructions
Get a chronological timeline of events in a session. Supports session id prefix match. Use 'tail' to get only the last N events (great for checking how a session ended). Use 'offset' to paginate through long sessions. NOT for searching — if you're looking for something specific in a session, use search_in_context instead of paginating this tool in a loop.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | ||
| limit | No | Max events to return (default 100) | |
| offset | No | Skip first N events (for pagination) | |
| tail | No | Return only the last N events of the session | |
| include_thinking | No | ||
| event_type | No | Filter to a single event type | |
| summary_only | No | Return only event_type, timestamp, tool_name, file_path — no content. Great for scanning long sessions. | |
| max_chars | No | Max total output characters |