# Session Debug

> >

- **Type:** Skill
- **Install:** `agentstack add skill-hoangsonww-claude-code-agent-monitor-session-debug`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hoangsonww](https://agentstack.voostack.com/s/hoangsonww)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [hoangsonww](https://github.com/hoangsonww)
- **Source:** https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/master/plugins/ccam-devtools/skills/session-debug
- **Website:** https://hoangsonww.github.io/Claude-Code-Agent-Monitor/

## Install

```sh
agentstack add skill-hoangsonww-claude-code-agent-monitor-session-debug
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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)
   - Total duration and active-vs-idle time

   ### Event Chain Analysis
   - Chronological event list with timestamps and durations
   - Identify the **critical path** (longest chain of dependent events)
   - Flag events that took unusually long
   - Highlight error events with full error context

   ### Agent Inspection
   - List all agents: type, task, status, duration
   - Subagent tree visualization (parent → children)
   - Agents that failed and their last known state
   - Agent switching patterns (when and why new agents spawned)

   ### Tool Execution Trace
   - Every tool invocation in order with: tool name, duration, success/failure
   - Failed tool calls with error messages
   - Tool retry patterns (same tool called multiple times)

   ### Anomaly Detection
   - Events out of expected order
   - Gaps in event timeline (>30s with no events)
   - Duplicate events or agent states
   - Token usage spikes (compaction indicators)

4. **Diagnosis**:
   - Root cause hypothesis (if errors present)
   - Contributing factors
   - Remediation suggestions

## Output Format

Present as a debug report with:
- Session summary header (ID, status, model, duration, cost)
- Color-coded timeline (✅ success, ❌ error, ⚠️ warning, ℹ️ info)
- Agent tree diagram
- Diagnosis section with numbered findings

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hoangsonww](https://github.com/hoangsonww)
- **Source:** [hoangsonww/Claude-Code-Agent-Monitor](https://github.com/hoangsonww/Claude-Code-Agent-Monitor)
- **License:** MIT
- **Homepage:** https://hoangsonww.github.io/Claude-Code-Agent-Monitor/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hoangsonww-claude-code-agent-monitor-session-debug
- Seller: https://agentstack.voostack.com/s/hoangsonww
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.