pr-provenance-stamp — плагин для Claude Code
Плагин pr-provenance-stamp дописывает в тело пулл-реквеста квитанцию: число промптов, оценку расхода, коды возврата тестов и долю строк, написанных агентом.
MIT ★ 586 обновлён 2026-10-26
/plugin marketplace add karanb192/claude-code-hooks
/plugin install pr-provenance-stamp@claude-code-hooksЧто делает pr-provenance-stamp
Плагин добавляет в тело пулл-реквеста короткую квитанцию. В ней число промптов, оценка расхода токенов и денег, все прогоны тестов и проверок типов с настоящими кодами возврата, а также разбивка добавленных строк: сколько написал агент, сколько человек.
Работают два хука. PostToolUse на Edit|MultiEdit|Write|Bash обновляет журнал сессии асинхронно, поэтому задержки в работе не добавляет: считает вызовы инструментов, строки агента и каждую команду проверки с её кодом. PreToolUse на Bash ловит gh pr create и glab mr create, берёт из транскрипта реальное число промптов и модели, спрашивает у git добавленные строки ветки и переписывает --body.
Если тело PR собирается через heredoc, $(...), бэктики или подстановку процесса, хук отступает и команду не трогает, так что квитанции в таком PR не будет. Настраивать нечего: состояние лежит в ~/.claude/pr-provenance-stamp/<session_id>.json, логи хуков в ~/.claude/hooks-logs/. Своих сетевых запросов хук не делает, но --body он переписывает, поэтому текст квитанции уедет в публичное описание PR на GitHub. Посмотреть её заранее можно командой /pr-provenance-stamp:provenance.
Какие задачи решает
- показать ревьюеру, какие тесты прогонялись и чем закончились
- отделить строки агента от правок человека
- прикинуть расход токенов на ветку перед публикацией PR
- посмотреть квитанцию до создания пулл-реквеста
- собрать журнал команд сессии без ручного копирования логов
Примеры запросов агенту
- Создай PR через
gh pr create, квитанция должна попасть в тело. - Покажи квитанцию текущей сессии:
/pr-provenance-stamp:provenance - Открой merge request через
glab mr createи приложи квитанцию к описанию.
Как установить pr-provenance-stamp
Через маркетплейс плагинов
/plugin marketplace add karanb192/claude-code-hooks/plugin install pr-provenance-stamp@claude-code-hooksПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о pr-provenance-stamp
Как установить pr-provenance-stamp в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add karanb192/claude-code-hooks, затем поставьте плагин: /plugin install pr-provenance-stamp@claude-code-hooks. После этого перезапустите Claude.
Что делает pr-provenance-stamp?
Дописывает в тело PR квитанцию: число промптов, оценку расхода, прогоны тестов с кодами возврата и разбивку строк между агентом и человеком.
Что будет, если тело PR собирается через heredoc?
Хук отступает и не трогает команду, поэтому квитанция в такой PR не попадёт. Так сделано, чтобы не сломать подстановку.
Исходный текст
pr-provenance-stamp · MIT
# pr-provenance-stamp > Stamps a provenance receipt (prompts, estimated spend, tests run with exit codes, and a truthful agent-authored line split) into your PR body on `gh pr create`. A PostToolUse hook keeps a per-session ledger: tool-call count, agent-authored line count, and every test/typecheck/lint command with its real exit code. When Claude runs `gh pr create` (or `glab mr create`), a PreToolUse (Bash) hook reads the session transcript for the real prompt count, estimated token/dollar spend, and models, asks git for the branch's total added lines to derive an agent-vs-human split, then appends a one-line receipt to the PR `--body`. If the command builds its body with a heredoc, `$(...)`, backticks, or process substitution, the hook defers and leaves the command untouched rather than risk corrupting it. ## Install ``` /plugin marketplace add karanb192/claude-code-hooks # once per machine /plugin install pr-provenance-stamp@claude-code-hooks ``` Restart Claude Code, done. (Or from a shell: `claude plugin install pr-provenance-stamp@claude-code-hooks`.) ## What it does | Event | Runs | What happens | |-------|------|--------------| | PostToolUse (`Edit\|MultiEdit\|Write\|Bash`) | async (zero added latency) | Updates the session ledger: tool-call count, agent-authored line count, and each test/typecheck command with its real exit code. | | PreToolUse (`Bash`) | sync | On `gh pr create` / `glab mr create`, rewrites the `--body` to append the receipt (prompt count, est. spend, test tally, agent-vs-human line split). Defers on unsafe shell constructs. | `/pr-provenance-stamp:provenance` renders the current session's receipt exactly as it would be stamped into a PR body, without creating one. ## Configuration No configuration needed. State is stored per session at `~/.claude/pr-provenance-stamp/<session_id>.json` (hook logs at `~/.claude/hooks-logs/`). ## Data & privacy Records tool-call counts, test commands with exit codes, agent line counts, and transcript-derived prompt/spend estimates. Everything is read and computed on your machine: the hook makes no network calls of its own; it only shells out to `git` for the line diff. It does rewrite the `--body` of your `gh pr create` command, so the receipt text becomes part of the public PR description that gets published to GitHub. ## Uninstall ``` /plugin uninstall pr-provenance-stamp@claude-code-hooks ```
© Karan Bansal · MIT · karanb192/claude-code-hooks