session-debug

1# Session Debug
2 
3Debug and inspect a Claude Code session from Agent Monitor data.
4 
5## Input
6 
7The user provides: **$ARGUMENTS**
8 
9This may be:
10- A session ID to debug
11- "latest" or "last" for the most recent session
12- "errors" to find and debug the most recent errored session
13 
14## Procedure
15 
161. **Identify the target session**:
17   - If session ID given: `GET /api/sessions/{id}` from `http://localhost:4820`
18   - If "latest": `GET /api/sessions?limit=1` (default sort: most recently updated first)
19   - If "errors": `GET /api/sessions?limit=10&status=error`
20 
212. **Collect full session data**:
22   - Session metadata: status, model, cwd, timestamps, duration
23   - Events: `GET /api/events?session_id={session_id}` — full event timeline
24   - Agents: `GET /api/agents?session_id={session_id}` — all agents in session
25   - Cost: `GET /api/pricing/cost/{session_id}`
26 
273. **Analyze the session**:
28 
29   ### Session Lifecycle
30   - Start time → first event → last event → end time
31   - Status transitions (active → working → completed/error)
32   - Total duration and active-vs-idle time
33 
34   ### Event Chain Analysis
35   - Chronological event list with timestamps and durations
36   - Identify the **critical path** (longest chain of dependent events)
37   - Flag events that took unusually long
38   - Highlight error events with full error context
39 
40   ### Agent Inspection
41   - List all agents: type, task, status, duration
42   - Subagent tree visualization (parent → children)
43…