tail-events — команда для Claude Code: что делает и как установить
Команда tail-events для Claude Code запрашивает последние события локального дашборда Agent Monitor и выводит их таблицей. Показывает вызовы инструментов и сбои агента.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-devtools@claude-code-agent-monitor-pluginsЧто делает tail-events
Команда обращается к API дашборда Agent Monitor по адресу http://localhost:4820/api/events с помощью curl и обрабатывает ответ через jq. По умолчанию она запрашивает 20 последних записей, но число N можно передать в аргументе.
Результат выводится в виде таблицы из трёх колонок: время, тип события и имя инструмента. Среди доступных типов событий — вызовы инструментов PreToolUse и PostToolUse, завершение шагов Stop, ошибки APIError, сжатия контекста Compaction и длительность шагов TurnDuration. Если инструмент не использовался, в строке ставится прочерк.
Команда работает только на чтение. Без запущенного локально сервиса Agent Monitor она не выполнится: при недоступности порта 4820 или пустом ответе команда попросит запустить дашборд через npm start в корне его репозитория.
Какие задачи решает
- посмотреть последние вызовы инструментов агента
- отследить ошибки APIError и сжатия контекста Compaction в реальном времени
- проверить тайминги сессии без перехода в браузер
Примеры запросов агенту
- /tail-events
- /tail-events 50
- Выведи последние 10 событий агента через /tail-events 10
Как установить tail-events
1Через маркетплейс плагинов
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-devtools@claude-code-agent-monitor-plugins2Вручную: положить файлы
.claude/commands/tail-events.mdВызов — /tail-events. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/tail-events.mdВызов — /prompts:tail-events. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/tail-events.prompt.mdВручную: положить файлы
.gemini/commands/tail-events.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о tail-events
Как установить tail-events в Claude Code?
Выполните команду /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, затем установите /plugin install ccam-devtools@claude-code-agent-monitor-plugins. Также можно вручную сохранить файл команды по пути .claude/commands/tail-events.md.
Что делает команда tail-events?
Она запрашивает последние события из API локального Agent Monitor и выводит их выровненной таблицей со временем, типом события и названием инструмента.
Что делать, если tail-events возвращает ошибку или пустой ответ?
Если запрос к API возвращает статус не 200 или пустое тело, запустите локальный сервер дашборда командой npm start из корня репозитория Claude-Code-Agent-Monitor.
Исходный текст
tail-events.md · MIT
---
description: Show the latest N ingested events with timestamp, event_type, and tool_name.
argument-hint: "[N]"
---
Show the most recent events from the Agent Monitor dashboard. Argument:
**$ARGUMENTS** — `N`, the number of events to show (default 20).
Fetch recent events and take the newest N:
```bash
N="${1:-20}"
curl -s "http://localhost:4820/api/events?limit=${N}" | jq -r '.[] | "\(.timestamp)\t\(.event_type)\t\(.tool_name // "-")"'
```
The `/api/events` list is returned newest-first; show the most recent `N`.
Render a compact, aligned table — one row per event:
```
TIME EVENT_TYPE TOOL_NAME
2026-06-25T14:03:11Z PostToolUse Bash
2026-06-25T14:03:09Z PreToolUse Bash
2026-06-25T14:02:58Z Stop -
```
Include `event_type` (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart,
SessionEnd, Notification, Compaction, APIError, TurnDuration) and `tool_name`
when present (use `-` for events without a tool). End with a one-line count:
`Showing latest <N> events.`
If the request returns a non-200 or empty body, say so and tell the user to start
the dashboard with `npm start` from the repo root. Read-only — never POST or
modify events.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor