Waybill

Приносите квитанции. Waybill — это учёт токенов для работы с помощью ИИ — плагин для Claude Code, который измеряет каждый токен, привязывает его к истории Jira, которую он реализовал, и превращает квитанции в отчёты о ценности, пакеты для обзора производительности и запросы на бюджет токенов, которые выдерживают проверку.

Waybill — это накладная, которая перечисляет груз и его стоимость. Вы отправляете; Waybill сохраняет детализированную запись.

Зачем

Два разговора во многом определяют год инженера, и оба основаны на одних и тех же неполных данных:

• «Стоил ли бюджет на ИИ того?» — всё больше команд выделяют токены Claude на основе продемонстрированной ценности. Используйте их хорошо, покажите это, получите больше.

• «Чего вы добились за этот цикл?» — обзоры производительности, пакеты на повышение, обзоры спринтов.

Люди отвечают на оба вопроса по памяти, накануне вечером, прилагательными. Тот, кто принимает решение, не может отличить честные утверждения от преувеличенных, поэтому дисконтирует всё. Waybill исправляет доказательства, а не убеждение: он записывает работу по мере её выполнения, привязывает каждое утверждение к артефакту — PR, задаче, тегу развёртывания, стенограмме — и не позволяет делать такие заявления, из-за которых ваше следующее предложение проигнорируют.

Related MCP server: Token Analyzer MCP

Шестьдесят секунд до первой квитанции

claude plugin marketplace add Jakeintech/waybill
claude plugin install waybill@waybill

Затем в сессии Claude Code скажите «инициализируй мою бухгалтерскую книгу waybill». Это вся настройка: никаких учётных записей, токенов, OAuth. Waybill заполняет вашу личность из git config, импортирует тарифы Anthropic по прейскуранту, чтобы затраты отображались с первого дня, проверяет настройку хранения стенограмм и отображает начальную квитанцию только из вашей локальной истории git — ваша отправленная работа, детализированная, менее чем за минуту.

Обновление

Claude Code не отправляет уведомления об обновлении плагинов; обновление — это одна команда, когда вам удобно:

claude plugin update waybill@waybill

Затем перезапустите Claude Code. waybill status (или waybill --version) показывает версию движка, которую вы используете. Waybill никогда не проверяет обновления самостоятельно — отсутствие сетевых вызовов без вашего запроса — это обязательство, а не упущение. Релизы и списки изменений находятся на странице релизов; следите за репозиторием (Watch → Custom → Releases), если хотите получать уведомления от GitHub по электронной почте.

Путь обновления (опционально, пять минут)

Подключение вашего трекера и хостинга git превращает коммиты в квитанции с историями, сюжетными точками, эпиками и временными метками слияния:

# Easiest — reuse your authenticated gh CLI:
export GITHUB_MCP_PAT="$(gh auth token)"
# Or mint a fine-grained read-only PAT (repos/PRs) at
# https://github.com/settings/personal-access-tokens and export it instead.

1. /mcp → завершите поток OAuth для atlassian (токен не нужен).

2. Скажите «синхронизируй мою бухгалтерскую книгу и дай мне начальный отчёт».

Не уверены, что подключено, а что нет? waybill status показывает и выводит точную команду для исправления отсутствующего.

Это импортирует ваши ~90 дней ваших собственных задач и объединённых PR и создаёт отчёт, основанный только на фактах — отправленные элементы, очки, PR, развёртывания — до того, как вы изменили хотя бы одну привычку. После этого открытие задач через бухгалтерскую книгу открывает более весомые утверждения (см. уровни ниже).

Как это работает

Каждый токен Claude Code измеряется детерминированно из ваших локальных стенограмм и привязывается к истории, которую он обслуживал, с указанием имени разрешающего компонента и уровня уверенности для каждого события, проверкой сохранения (Σ приписанное = Σ наблюдаемое, на сессию), которую вы можете повторно запустить офлайн с помощью waybill verify, папкой входящих для неоднозначных остатков и диагностикой отходов по истории (что купили токены — и на что они потрачены в циклах повторных попыток). Начиная с версии 1.0 схема заморожена: квитанции — это контракт.

Уровни доказательств (вся суть)

Каждое число в отчёте указывает, откуда оно взялось:

1. Факты — временные метки слияния, теги развёртывания, сюжетные очки, количество токенов.

2. Базовые дельты — ваша собственная скорость/время цикла до Claude по сравнению с текущим.

3. Предварительно зарегистрированные оценки — записаны до работы, представлены в виде диапазонов.

4. Ретроспективные суждения — хранятся в бухгалтерской книге, по умолчанию исключаются из питчей.

Плюс структурная честность: хранилище только для добавления (исправления заменяют, никогда не перезаписывают), диапазоны никогда не сворачиваются до средних точек, ценность учитывается только при слиянии или развёртывании, а затраты (потраченные токены, переделки) отображаются в каждом питче. Полные правила: методология.

Пресеты отчётов

• token-pitch — запрос, квитанции, книга расходов, тренд эффективности, прогноз.

• perf-review — результаты уровня эпика за период обзора, включая работу по обзорам, инцидентам, документации.

• sprint-recap / quarterly — текущая запись.

Отчёты отображаются на трёх уровнях аудитории — self, internal, external — с детерминированной псевдонимизацией перед тем, как что-либо покинет организацию.

Что Waybill никогда не будет делать

• Никакого режима менеджера, никакой слежки. Он запрашивает только ваши назначенные задачи и ваши авторские PR.

• Никакого ранжирования коллег. Методология по замыслу отказывается от сравнения отдельных коллег — вы соревнуетесь со своим собственным базовым уровнем, а не с Дейвом.

• Никакого хостинга, никакой телеметрии. Всё хранится в ~/.waybill/ (локальный git-репозиторий, который принадлежит вам).

• Никакого учёта времени. Он записывает результаты и оценки, а не нажатия клавиш.

Это обязательства, а не пробелы. См. ROADMAP.md.

Приостановка, уменьшение активности, уход

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

• Приостановить учёт (работа с клиентом, общий компьютер, отладка): установите "metering": { "enabled": false } в ~/.waybill/config.json. В приостановленном состоянии ничего не захватывается и не учитывается — waybill status сообщает metering: PAUSED, чтобы состояние никогда не было незаметным. Существующие данные не затрагиваются; переключите обратно, чтобы возобновить.

• Уменьшить количество уведомлений: "notices": { "level": "minimal" } оставляет только строки о пороге бюджета ("off" отключает всё, что Waybill говорит без запроса — учёт всё ещё работает). Напоминание о продлении (budgets.renewal_reminder_days, по умолчанию 14) подчиняется тому же переключателю.

• Забрать свои данные: waybill export --format json (или csv) выгружает книгу расходов; вся книга уже находится в виде обычного JSONL в ~/.waybill/ — локальном git-репозитории, который принадлежит вам. Скопируйте куда угодно; ничего не является проприетарным.

• Удалить инструмент, сохранить данные: claude plugin uninstall waybill@waybill, затем перезапустите Claude Code. Хуки и навыки исчезнут; ~/.waybill/ останется вашим.

• Удалить всё: rm -rf ~/.waybill (или $WAYBILL_HOME, если вы его установили). Это весь след — Waybill не хранит никакого другого состояния. Стенограммы сессий в ~/.claude/ принадлежат Claude Code, а не Waybill, и регулируются его настройкой cleanupPeriodDays.

По сравнению с альтернативами

Документы

• Учебное пособие: краткое руководство в этом README, выше.

• Как сделать: заменить Jira/GitHub на Linear, GitLab, Bitbucket…

• Справка: схема записей бухгалтерской книги и конфигурации · справочник навыков · план тестирования — документы, которые читает Claude, — это документы, которые читаете вы.

• Объяснение: методология измерения ценности · дорожная карта и область действия · бренд и голос · заморозка схемы и политика миграции

• Спецификация: полная спецификация продукта — нормативный дизайн, который реализует выпущенный движок.

Часто задаваемые вопросы

Работает ли это без Jira или GitHub? Да — это настройка по умолчанию. Режим только git требует нулевой настройки и нулевой аутентификации: учёт, атрибуция по ветке/тегу и начальная квитанция работают из локальных данных. Подключение трекера/хостинга git улучшает квитанции; любой из них с MCP-сервером может быть заменён (адаптеры).

Могу ли я использовать это для обзоров производительности, если моя компания не нормирует токены? Да — это пресет perf-review. Питч токенов — это один из результатов бухгалтерской книги, а не её суть.

Конфиденциальны ли мои данные? Локальный JSONL в вашем домашнем каталоге; единственные сетевые вызовы — это MCP-вызовы, которые вы разрешаете, ограниченные вашими собственными элементами.

Почему он не сравнивает меня с коллегами? Сюжетные очки несопоставимы между людьми, сбор информации о коллегах воспринимается как слежка, а ваша собственная траектория — более весомое доказательство. (методология §6)

Как мне обосновать расходы на ИИ перед руководителем? Запустите sync, затем «создай мой питч токенов». Принесите одностаничный документ; сохраните бухгалтерскую книгу для дополнительных вопросов.

Участие

Приветствуются задачи и PR — см. CONTRIBUTING.md, дорожную карту и задачи с меткой good first receipt. Конфигурации адаптеров для других трекеров — наиболее желаемый вклад. Пожалуйста, прочитайте Кодекс поведения; сообщения о безопасности отправляйте через SECURITY.md.

Лицензия

MIT