session-debug

name

session-debug

description

Debug a specific session by inspecting its full event chain (PreToolUse, PostToolUse, Stop, SubagentStop, Compaction, APIError, TurnDuration, Notification events), agent hierarchy (recursive parent/child tree with subagent_type and depth), token usage with compaction baselines, workflow intelligence data (orchestration DAG, error propagation by depth), and session metadata (thinking_blocks, turn_count, total_turn_duration_ms).

Session Debug

Debug and inspect a Claude Code session from Agent Monitor data.

Input

The user provides: $ARGUMENTS

This may be:

• A session ID to debug
• "latest" or "last" for the most recent session
• "errors" to find and debug the most recent errored session

Procedure

1. Identify the target session:

   • If session ID given: GET /api/sessions/{id} from http://localhost:4820
   • If "latest": GET /api/sessions?limit=1 (default sort: most recently updated first)
   • If "errors": GET /api/sessions?limit=10&status=error

2. Collect full session data:

   • Session metadata: status, model, cwd, timestamps, duration
   • Events: GET /api/events?session_id={session_id} — full event timeline
   • Agents: GET /api/agents?session_id={session_id} — all agents in session
   • Cost: GET /api/pricing/cost/{session_id}

3. Analyze the session:

   Session Lifecycle

   • Start time → first event → last event → end time
   • Status transitions (active → working → completed/error)