Skip to main content
Session Replay records every action Claude takes during a task and lets you play it back on a timeline. Useful for understanding what happened, debugging issues, or reviewing completed work.

Accessing Session Replay

  1. Click on any task to open the Task Detail modal
  2. Click the Session Replay button in the top-right corner
  3. The replay panel opens at the bottom of the modal

Event Types

Each event is color-coded on the timeline:
EventColorDescription
Tool CallBlueClaude invoked a tool (Read, Edit, Bash, Grep, etc.)
Tool ResultGreenResult returned from a tool execution, with duration
Usage FinalAmberFinal token/cost summary when task completes
SystemGraySystem messages (initialization, status changes)
Rate LimitRedRate limit events from the API

Timeline Controls

  • Play/Pause — Automatically step through events at 300ms intervals
  • Click timeline bar — Jump to any point in the session
  • Click event markers — Select specific events on the timeline
  • Event list — Scrollable list on the left, click to select and view details

Event Details

Select any event to see its full data:
  • Tool calls: Tool name, input parameters (file path, command, pattern)
  • Tool results: Output preview, error status, execution duration in ms
  • Usage: Input/output tokens, total cost, model used, number of turns
Events are recorded in real-time during task execution and stored in the task_events database table. The timeline shows elapsed time from the first event.