Skills

Event Trace

Trace the full event chain for one Claude Code session into an ordered timeline of...

Install

npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill event-trace -g -a claude-code -y
Category
Testing
Updated
5d ago
License
MIT
Context cost
Lightabout 663 tokens
Runs scripts
No, instructions only

What it does

Trace the full event chain for one Claude Code session into an ordered timeline of every event type with tool_name and summary, highlighting gaps, out-of-order events, and failures. Reads /api/events?session_id= and /api/sessions/:id from the Agent Monitor dashboard. Use when debugging what a session actually did, step by step.

Event Trace

Build a chronological, annotated event timeline for a single session.

Input

The user provides: $ARGUMENTS

This is a session ID. It may also be:

  • latest / last, trace the most recently updated session
  • errors, trace the most recent session whose status is error

Data Sources

EndpointReturns
GET /api/sessions?limit=Nsession list (used to resolve latest/errors and the target id)
GET /api/sessions/:idfull session detail (status, model, cwd, started_at, ended_at, cost, nested agents + events)
GET /api/events?session_id=Xthe ordered event stream: event_type, tool_name, summary, data, timestamp

Report Sections

1. Resolve the session

If $ARGUMENTS is a raw id, use it. If latest/last, call GET /api/sessions?limit=1. If errors, call GET /api/sessions?limit=10&status=error and pick the newest. Confirm the id resolves via GET /api/sessions/:id; if not, report it as missing and stop.

2. Session header

From GET /api/sessions/:id: id, status, model, cwd, started_at → ended_at, total duration, cost (USD to 4 decimals), and counts (events, agents).

3. Ordered timeline

From GET /api/events?session_id=X, list every event in timestamp order. One row per event:

| # | time | Δ since prev | event_type | tool_name | summary |

Cover all event types present: SessionStart, PreToolUse, PostToolUse, Stop, SubagentStop, Compaction, APIError, TurnDuration, Notification, SessionEnd.

Read the whole SKILL.md on GitHub

More in Testing