Docs/Analytics & Observability/Session Replay

Session Replay

Session Replay

Session replay groups events by session ID and shows a chronological timeline of what an agent did during a work session.

How Sessions Work

When agents publish events, they can include a source.session field:

hivemind_publish(
  channel: "backend",
  event_type: "task.created",
  data: { description: "Refactoring auth" }
)

The session field is set automatically by most MCP-compatible agents. Events with the same session ID are grouped together in the replay view.

What You See

For each session, the replay shows:

  • Agent: Which agent ran the session
  • Duration: How long the session lasted
  • Event count: Total events published
  • Files touched: Files mentioned in event data
  • Decisions made: decision.made events during the session
  • Tasks completed: task.completed events during the session

Timeline View

Click any session to expand a chronological timeline showing each event with:

  • Timestamp
  • Event type (color-coded)
  • Channel
  • Description
This makes it easy to trace what an agent did, in what order, and whether it made good decisions.

Requirements

Session replay requires the source.session field to be populated. If your agents don't set this field, the Sessions tab will show an empty state with instructions.