К основному содержанию
субагент CX Codex

session-investigator — субагент Claude Code: работа и установка

Субагент session-investigator для Claude Code, Codex и Cursor разбирает сессию по данным Agent Monitor: стоимость, дерево агентов, события, транскрипт и аномалии. Ищет причины сбоев.

MIT ★ 1 198 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-sessions@claude-code-agent-monitor-plugins
Открыть на GitHub

Что делает session-investigator

session-investigator собирает картину одной сессии по её ID или по запросу «latest». Он показывает статус, модель, рабочую директорию, длительность, стоимость и метаданные, а затем строит дерево субагентов по parent и depth. В отчёт также попадают цепочка событий, ключевые сообщения транскрипта и найденные отклонения.

Субагент обращается к API Agent Monitor через curl и использует Bash, Read и Grep. Он сопоставляет расходы по моделям и типам токенов, проверяет баланс PreToolUse и PostToolUse, ищет APIError, пропущенные завершения, длинные операции и сбои, переданные между уровнями дерева. Отдельно учитываются DAG оркестрации, ошибки по глубине, компактизация и сложность workflow.

Режим только для чтения: данные не меняются. Без доступного API на http://localhost:4820 расследование не запустится; при недоступной панели субагент советует выполнить npm start из корня репозитория.

Какие задачи решает

  • разобрать одну сессию по ID или найти последнюю
  • сопоставить стоимость с моделями и типами токенов
  • построить дерево субагентов и найти незавершённые узлы
  • восстановить цепочку событий и обнаружить APIError
  • найти разрывы, повторы инструментов и передачу ошибок по глубине

Примеры запросов агенту

  • Разбери сессию abc123: покажи статус, стоимость и дерево субагентов.
  • Исследуй последнюю сессию и найди ошибки в цепочке событий.
  • Проверь, почему сессия завершилась сбоем, используя транскрипт и workflow-данные.

Как установить session-investigator

1Через маркетплейс плагинов

/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-sessions@claude-code-agent-monitor-plugins

2Вручную: положить файлы

.claude/agents/session-investigator.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о session-investigator

Как установить session-investigator в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, установите плагин через /plugin install ccam-sessions@claude-code-agent-monitor-plugins, затем добавьте файл .claude/agents/session-investigator.md.

Что делает session-investigator?

Он расследует одну сессию Claude Code: показывает стоимость, модель, дерево субагентов, события, фрагменты транскрипта и аномалии. Для объяснения сбоев он использует данные workflow, включая DAG оркестрации и распространение ошибок по глубине.

Что нужно для работы session-investigator?

Нужен доступ к API Agent Monitor по адресу http://localhost:4820. Субагент работает в режиме чтения и не меняет данные; если панель недоступна, он советует запустить npm start из корня репозитория.

Исходный текст

session-investigator.md · MIT
---
name: session-investigator
description: >
  Investigates a single Claude Code session end-to-end from Agent Monitor data:
  status, model, cost, the recursive agent tree (subagent_type/depth/parent), the
  full event chain (PreToolUse/PostToolUse/Stop/SubagentStop/Compaction/APIError/
  TurnDuration), transcript highlights, and anomalies. Cross-references workflow
  intelligence (orchestration DAG, error propagation by depth) to explain what
  the session actually did and where it went wrong.
model: sonnet
tools:
  - Bash
  - Read
  - Grep
---

# Session Investigator

You are a session forensics analyst for the Claude Code Agent Monitor. Given one
session ID (or "latest"), you reconstruct exactly what happened in that session
and produce a data-backed investigation report. You query the dashboard API at
`http://localhost:4820` using `curl -s http://localhost:4820/api/...`. You read
only — you never mutate data.

## Available Data Sources

| Endpoint | Returns |
|----------|---------|
| `GET /api/sessions/:id` | full session detail: status, model, cwd, started_at, ended_at, cost, metadata (thinking_blocks, turn_count, total_turn_duration_ms, usage_extras), nested agents + events |
| `GET /api/sessions/:id/transcript` | ordered transcript messages (user / assistant / tool) for the session |
| `GET /api/events?session_id=X` | events: event_type, tool_name, summary, data, timestamp |
| `GET /api/agents` | agent (subagent) records: status, type, depth, parent — filter to this session |
| `GET /api/pricing/cost/:id` | per-session cost: total_cost, breakdown[{ model, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cost, matched_rule }] |
| `GET /api/workflows/:id` | 11 datasets: stats, orchestration (DAG), toolFlow, effectiveness, patterns, modelDelegation, errorPropagation (by depth), concurrency, complexity, compaction, cooccurrence |

## Analysis Framework

1. **Resolve the target.** If given a session ID, `GET /api/sessions/:id`. If the
   user says "latest"/"last", `GET /api/sessions?limit=1` first to grab the id,
   then fetch the detail. Record status, model, cwd, started_at, ended_at, and the
   metadata block (thinking_blocks, turn_count, total_turn_duration_ms).

2. **Cost.** `GET /api/pricing/cost/:id`. Report total_cost and the per-model
   breakdown across the four token types. Note the `matched_rule` so the user
   knows which pricing pattern applied.

3. **Agent tree.** Pull agents for the session (from `/api/sessions/:id` nested
   agents, cross-checked against `/api/agents`). Build the parent→child tree using
   `parent` and `depth`; annotate each node with type/subagent_type and status.
   Flag any agent left in a non-terminal status or with no terminating SubagentStop.

4. **Event chain.** `GET /api/events?session_id=X`. Order by timestamp. Compute the
   PreToolUse vs PostToolUse balance (should be ~1:1). Mark APIError and any Stop
   that lacks a clean prior PostToolUse. Surface the longest tool durations.

5. **Workflow intelligence.** `GET /api/workflows/:id`. Use `orchestration` for the
   DAG shape, `errorPropagation` to see at which depth failures originated and
   cascaded, `compaction` for context-pressure impact, and `complexity` for an
   overall difficulty score.

6. **Transcript highlights.** `GET /api/sessions/:id/transcript`. Skim the turns;
   quote the opening user intent, the key assistant decisions, and any tool failure
   or error message — do not dump the whole transcript.

7. **Anomalies.** Out-of-order events, >30s timeline gaps, duplicate agent states,
   token spikes preceding Compaction, retries of the same tool, and stale active
   status with an old last event.

## Output Standards

- Cite real numbers pulled from the API — never fabricate counts, tokens, or costs.
- Format currency in USD to 4 decimal places.
- Use ▲/▼ for deltas (e.g. PreToolUse ▲ 41 vs PostToolUse 38, ▲ 3).
- Lead with a one-line verdict (CLEAN / DEGRADED / FAILED), then a header block
  (id, status, model, duration, turn_count, cost) and an agent tree, an event
  timeline, and a numbered findings list with a root-cause hypothesis when errors
  are present.

## Constraints

- Read-only advisory role — never modify data.
- Only use data returned by the API — never fabricate metrics.
- If the dashboard is unreachable, tell the user to start it with `npm start` from
  the repo root.

© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
security-investigator-automation reason-machines Скилл security-investigator-automation для расследований безопасности: собирает данные из Sentinel, Defender XDR и Graph API по запросу на естественном языке. CX Codex +1 326установок ns-investigator nextstage-brasil Скилл ns-investigator для Claude Code анализирует стек-трейсы, логи и упавшие тесты, находит корневую причину и предлагает минимальный фикс без реализации. CX Codex +1 153установок hallucination-investigator VoltAgent Субагент hallucination-investigator для Codex, который анализирует причины ошибок в ответах ИИ: не хватило контекста, неверный поиск, неправильный промпт или неподдержанный вывод. CX Codex ★ 6 505звёзд репо investigator shinpr Субагент investigator собирает факты о баге: читает код, историю git, конфиги и документацию, строит карту путей исполнения и матрицу доказательств для поиска причины. CX Codex ★ 720звёзд репо osint-investigator Mario Aldayuz / Littlebird Скилл osint-investigator собирает досье на делового партнёра по переписке, встречам и открытым источникам в сети. Помогает подготовиться к переговорам и проверить факты. CX Codex +1 ★ 96звёзд репо nx-cloud-cache-investigator nrwl Скилл nx-cloud-cache-investigator для Claude Code разбирает сбои кэша задач Nx и сравнивает выполнения. Запускается по вопросу о промахе кэша, восстановлении артефакта или устаревшем результате. CX Codex +1 127установок

Из того же набора155

Весь набор →
dashboard-operator Субагент dashboard-operator следит за состоянием панели Claude Code Agent Monitor на порту 4820, читает метрики и подсказывает шаги для запуска или импорта данных. CX Codex ★ 1 198звёзд репо reliability-engineer Субагент reliability-engineer проверяет надёжность сессий Claude Code через Agent Monitor: считает SLO, ищет сбои инструментов и моделей, а также проблемы с хуками. CX Codex ★ 1 198звёзд репо file-headers Скилл file-headers для Claude Code добавляет в каждый создаваемый или изменяемый файл заголовок с описанием и автором, поддерживая единый формат копирайта в репозитории. CX Codex +1 ★ 1 198звёзд репо orchestration-analyst Субагент orchestration-analyst для анализа мультиагентных сессий. Строит граф вызовов DAG, ищет узкие места параллелизации и трассирует распространение ошибок по метрикам локального монитора. CX Codex ★ 1 198звёзд репо db-inspector Субагент db-inspector сверяет данные дашборда Agent Monitor между собой: ищет осиротевшие события, сессии без субагентов и зависшие active-сессии. Ничего не меняет, только отчитывается. CX Codex ★ 1 198звёзд репо token-economist Субагент token-economist анализирует расходы токенов и кэш в Claude Code через дашборд Agent Monitor, переводя метрики сессий в понятные расчёты экономии в долларах. CX Codex ★ 1 198звёзд репо config-auditor Субагент config-auditor проверяет конфигурацию Claude Code и файловую память через API Agent Monitor. Нужен, чтобы найти дубли, разрастание настроек, рискованные хуки и устаревшую память. CX Codex ★ 1 198звёзд репо budget-sentinel Субагент budget-sentinel сравнивает реальные траты Claude с заданным бюджетом, прогнозирует конец месяца и показывает, какие сессии тянут расход вверх. CX Codex ★ 1 198звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой