К основному содержанию
плагин

nerf-receipts — плагин для Claude Code: метрики сессий

Плагин nerf-receipts считает сбои инструментов, повторные правки одного файла и токены на задачу. Помогает увидеть, меняются ли эти показатели вместе со сменой модели.

MIT ★ 586 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add karanb192/claude-code-hooks
/plugin install nerf-receipts@claude-code-hooks
Открыть на GitHub

Что делает nerf-receipts

Хуки собирают данные по сессиям Claude Code: считают вызовы и сбои инструментов, повторные правки одного файла и завершения ходов. При закрытии сессии плагин разбирает расход токенов в транскрипте и добавляет запись в локальный журнал JSONL. Текст транскрипта, команды и ввод инструментов в журнал не попадают.

При следующем запуске появляется карточка тенденций с графиками по модели и версии Claude Code. Плагин отмечает сдвиги среднего от 25%, совпавшие со сменой модели; для отчёта нужно накопить минимум 6 сессий. Карточку также можно запросить командой /nerf-receipts:receipts. Данные остаются на компьютере, сетевых запросов скрипт не делает. Учтите: разбор транскрипта ограничен 20000 строками и 16 MiB.

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

  • отследить долю неудачных вызовов инструментов
  • заметить повторные правки одного файла в сессии
  • сравнить расход токенов на задачу между моделями
  • проверить, совпал ли сдвиг метрик со сменой модели

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

  • Покажи тенденции качества по моделям командой /nerf-receipts:receipts.
  • Сравни долю сбоев инструментов и расход токенов на задачу между версиями модели.
  • Проверь, изменились ли метрики после смены модели.

Как установить nerf-receipts

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

/plugin marketplace add karanb192/claude-code-hooks
/plugin install nerf-receipts@claude-code-hooks

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

Вопросы о nerf-receipts

Как установить nerf-receipts в Claude Code?

Выполните команды по порядку: /plugin marketplace add karanb192/claude-code-hooks, затем /plugin install nerf-receipts@claude-code-hooks. После этого перезапустите Claude Code.

Что делает nerf-receipts?

Плагин записывает локальные метрики каждой сессии, включая сбои инструментов, повторные правки файлов и токены на задачу. Он показывает графики и отмечает сдвиги, совпавшие со сменой модели.

Какие данные nerf-receipts сохраняет?

В журнал попадают счётчики и пути изменённых файлов. Ввод инструментов, команды и текст транскрипта не сохраняются; скрипт не отправляет сетевые запросы.

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

nerf-receipts · MIT
# nerf-receipts

> A personal flight recorder for Claude Code quality: records your own per-session failure rate, edit churn, and tokens/task by model version, and flags real shifts when a model changes.

nerf-receipts registers on six hook events. As you work, `PostToolUse` and `PostToolUseFailure` count every tool call, its failures, and same-file edit churn; `Stop` and `SubagentStop` count turn-end events, all async, so they add no latency. At `SessionEnd` it parses token usage from the session transcript, finalizes four per-session signals (tool-failure rate, edit churn, turn-end count, tokens-per-completed-task), and appends one record to a JSONL ledger. At `SessionStart` it renders a trend card (a sparkline per metric, keyed by model id and Claude Code version) and flags meaningful shifts (>=25% relative change in the mean) that coincide with a model change. The same card is available on demand via `/nerf-receipts:receipts`.

## Install

```
/plugin marketplace add karanb192/claude-code-hooks   # once per machine
/plugin install nerf-receipts@claude-code-hooks
```

Restart Claude Code, done. (Or from a shell: `claude plugin install nerf-receipts@claude-code-hooks`.)

## What it does

| Event | Runs | What happens |
| ----- | ---- | ------------ |
| `PostToolUse` | async (zero added latency) | Counts every tool call; records failures and same-file edit churn |
| `PostToolUseFailure` | async (zero added latency) | Counts tool-call failures and edit churn |
| `Stop` | async (zero added latency) | Counts turn-end events |
| `SubagentStop` | async (zero added latency) | Counts subagent turn-end events |
| `SessionEnd` | sync | Parses transcript tokens, finalizes the session, appends the record to the ledger |
| `SessionStart` | sync | Renders the trend card and flags model-change shifts via `additionalContext` |

`/nerf-receipts:receipts` renders the model-quality trend card on demand (failure rate, edit churn, tokens/task by model version, each with a sparkline).

## Configuration

No environment variables. Tuning constants live at the top of `nerf-receipts.js`:

- `MIN_SESSIONS_FOR_TREND` = 6: sessions required before a trend or shift is reported
- `TREND_WINDOW` = 200: most recent sessions the trend card considers
- `MAX_TRANSCRIPT_LINES` = 20000 and `MAX_TRANSCRIPT_BYTES` = 16 MiB: caps on transcript parsing

State is stored as a JSONL ledger under `~/.claude/nerf-receipts/` (per-session in-flight logs under `~/.claude/nerf-receipts/sessions/`); event logs go to `~/.claude/hooks-logs/<date>.jsonl`.

## Data & privacy

Only counts and edited file paths are recorded: tool inputs, commands, and transcript text are never persisted, so secrets in commands cannot land in the ledger. The script makes no network calls (it requires only `fs`, `path`, and `os`); everything stays on your local machine.

## Uninstall

```
/plugin uninstall nerf-receipts@claude-code-hooks
```

© Karan Bansal · MIT · karanb192/claude-code-hooks

Похожие плагины

Все плагины по теме «DevOps и инфраструктура» →
nueton-receipts Nikxius, Inc. Плагин nueton-receipts считает, сколько раз агент сказал «готово», и сверяет каждое утверждение с командами той же сессии: подтверждено, опровергнуто или не проверено. CX Codex ★ 1 596звёзд репо vstack-s8-package-maintain Hao AI Lab Скилл vstack-s8-package-maintain для Claude Code упаковывает проверенную область проекта в регрессионный сценарий из пяти шагов. Он подключается при подготовке проверок и их обновлении после изменений кода. CX Codex +1 ★ 89звёзд репо receipts официальный Anthropic Скилл receipts собирает личный отчёт об активности Claude Code из локальных транскриптов сессий — для согласования бюджета с руководителем или self-review. CX Codex +1 2 052установок agent-decision-receipts Alireza Rezvani Скилл agent-decision-receipts выдаёт подписанную квитанцию на значимое действие агента — деплой, удаление, платёж, выдачу доступа — и проверяет её потом по одному сертификату. CX Codex +1 44установок PEAC Protocol: Signed interaction receipts peacprotocol PEAC Protocol: Signed interaction receipts — MCP-сервер для проверки, выпуска и декодирования подписанных записей взаимодействий по протоколу PEAC. CX Codex +1 ★ 15звёзд репо CMD+RVL Receipts cmdrvl MCP-сервер CMD+RVL Receipts для Claude Code сверяет утверждения с публичными документами CMBS и купонами NPORT-P. Он возвращает ссылки на документы и отмечает фрагменты, которые не удалось проверить. CX Codex +1

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

Весь набор →
protect-secrets Плагин protect-secrets для Claude Code проверяет вызовы Read, Edit, Write, Bash и Grep и блокирует доступ к секретам или сначала запрашивает разрешение. ★ 586звёзд репо bounty-board Плагин bounty-board превращает TODO и FIXME в вашем коде в растущие по возрасту XP-бонусы. Плагин сканирует репозиторий, оценивает долг в очки и подсказывает три самых прибыльных задачи прямо в сессии. ★ 586звёзд репо dead-end-registry Плагин dead-end-registry сохраняет отменённые решения и предупреждает, если вы или модель снова пытаетесь пойти по тупиковому пути. Помогает не тратить токены на повторные ошибки. ★ 586звёзд репо standup-autopilot Плагин standup-autopilot собирает задачи, тесты, PR и блокеры из транскриптов сессий и оформляет сводку для дейли. Открытые блокеры возвращаются в следующую сессию. ★ 586звёзд репо pr-provenance-stamp Плагин pr-provenance-stamp дописывает в тело пулл-реквеста квитанцию: число промптов, оценку расхода, коды возврата тестов и долю строк, написанных агентом. ★ 586звёзд репо dead-rules-audit Плагин dead-rules-audit аудирует соблюдение правил из CLAUDE.md во время сессии Claude Code и отмечает правила, которые агент постоянно игнорирует. ★ 586звёзд репо cache-tax Плагин cache-tax показывает, во сколько обойдётся возврат в сессию после того, как часовой кеш промпта остыл, — до того, как вы нажмёте Enter. ★ 586звёзд репо context-hogs Плагин context-hogs считает расход токенов по файлам проекта и показывает отчёт с самыми затратными местами. ★ 586звёзд репо

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

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