# session-investigator

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

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 1198 у репозитория
- Автор: Son Nguyen
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/plugins/ccam-sessions/agents/session-investigator.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/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` из корня репозитория.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
```
В чате агента (не в терминале):
```text
/plugin install ccam-sessions@claude-code-agent-monitor-plugins
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/session-investigator.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/session-investigator.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/session-investigator.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/plugins/ccam-sessions/agents/session-investigator.md

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

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

## Похожие
- [security-investigator-automation](https://affpapa.org/nevibecode/skills/security-investigator-automation.md) — скилл · 326 установок
- [ns-investigator](https://affpapa.org/nevibecode/skills/ns-investigator.md) — скилл · 153 установки
- [hallucination-investigator](https://affpapa.org/nevibecode/agents/hallucination-investigator.md) — субагент · ★ 6505 у репозитория
- [investigator](https://affpapa.org/nevibecode/agents/investigator.md) — субагент · ★ 720 у репозитория
- [osint-investigator](https://affpapa.org/nevibecode/skills/osint-investigator.md) — скилл · ★ 96 у репозитория
- [nx-cloud-cache-investigator](https://affpapa.org/nevibecode/skills/nx-cloud-cache-investigator.md) — скилл · 127 установок

Из того же набора: [hoangsonww/claude-code-agent-monitor](https://affpapa.org/nevibecode/by/hoangsonww/claude-code-agent-monitor.md) — 155 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
