burn CLI
Локальный CLI считает токены и доллары по репозиториям, веткам и моделям из транскриптов Claude Code, Codex и OpenCode
- 89 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- CLI читает локальные транскрипты агентов, где могут быть фрагменты кода и промптов, и пишет историю в `~/.burn`; сеть не используется.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/aashish254/burn/main/install.sh | bashПервая команда из README: установщик проверяет контрольную сумму релиза и ставит CLI в `~/.burn-cli`.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- CLI читает локальные транскрипты агентов, где могут быть фрагменты кода и промптов, и пишет историю в `~/.burn`; сеть не используется.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
burn читает транскрипты, которые агенты и так хранят на диске, и складывает расходы. Команда `burn` показывает траты по репозиториям, моделям и дням, `burn work` показывает цену фичи по ветке, `burn blame feature/pay` считает стоимость одной ветки, а `burn doctor` ищет, где деньги уходят зря. Есть прогноз `burn forecast`, лимит `burn budget` с кодом выхода 3 при превышении и отчет `burn report` в Markdown. Поддерживаются Claude Code, OpenCode, Codex CLI и Gemini CLI. Сеть, аккаунт и телеметрия не нужны. Цены берутся из таблицы `~/.burn/pricing.json`, и если модели в ней нет, burn показывает токены и прочерк вместо стоимости. Для команд есть выгрузка и слияние данных, формат главной книги открыт как протокол ULP 1.0.
Для кого. Разработчикам и командам, которые хотят знать, сколько стоит работа с агентами по репозиториям и веткам, и не передавать данные в облако.
Подходит, если
- Счет за токены вырос, и нужно найти репозиторий или ветку, на которые ушли деньги
- В CI проверяют, что пулл-реквест не превысил бюджет, по коду выхода 3
- Команда собирает расходы по людям без отдельного сервера через `burn export`, `merge` и `team`
- Нужен прогноз траты на следующий месяц по текущему темпу
Не подходит, если
- Агент не оставляет локальных транскриптов, например облачный сервис без файлов на диске
- Нужна точная сумма из счета провайдера: burn показывает оценку по вашей таблице цен
- Нужно ограничить расходы на лету: burn измеряет и проверяет бюджет, но ничего не блокирует
Пример запроса к агенту
Запусти `burn work` и покажи, сколько стоила ветка feature/payments-refactor за последнюю неделюОграничения
Нужен Node.js 22.5 или новее со встроенным `node:sqlite`, поддерживаются macOS и Linux. Установка через `curl ... | bash`: сам скрипт проверяет контрольную сумму релиза, но прочитайте его до запуска. Пакета в npm пока нет. Стоимость почти всегда оценка по таблице цен, фактическую сумму автор берет только у OpenCode. Cursor в списке планируется, OpenClaw удержан до уточнения формата хранения, а чтение чужих журналов зависит от того, что агенты пишут на диск.
Как отключить. Удалите каталог `~/.burn-cli` и ссылку `burn` из `~/.local/bin`. Накопленную историю в `~/.burn` стирают отдельно.
Частые вопросы
Как установить burn?
Выполните `curl -fsSL https://raw.githubusercontent.com/aashish254/burn/main/install.sh | bash`. Альтернатива: `git clone https://github.com/aashish254/burn && cd burn && npm link`.
Откуда burn берет данные?
Из локальных файлов агентов: Claude Code хранит JSONL в `~/.claude/projects`, OpenCode базу SQLite, Codex и Gemini CLI свои журналы. Команда `burn sources` покажет, что найдено.
Уходят ли данные в сеть?
Нет, сетевых запросов, аккаунта и телеметрии нет. Выгрузка для коллег создается файлом `burn export -o me.burn.json`.
Чем burn отличается от ccusage?
burn связывает расходы с ветками и работой, умеет бюджеты с кодом выхода для CI и слияние данных команды. ccusage сосредоточен на отчетах по использованию.
Как ограничить расходы в CI?
Выполните `burn budget --repo app --max 25`: при превышении лимита код выхода будет 3, и CI отличит нарушение бюджета от сбоя инструмента. Сам burn ничего не блокирует.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и MCP-сервер, которые считают расход токенов по 41 инструменту и агенту, показывают трату по проекту и модели и помогают срезать лишние токены
Отчеты по токенам и стоимости Claude Code, Codex, Gemini CLI и других агентов по локальным логам: по дням, месяцам и сессиям
TokenTracker считает токены и расходы в Claude Code, Codex, Cursor, Gemini CLI и других агентах по локальным логам и показывает их на панели localhost:7680
Локальный CLI показывает, куда уходят токены в Claude Code, Codex и opencode, и придерживает дорогие сообщения
Монитор лимитов и расхода токенов для Claude Code, Codex, Antigravity и Grok CLI: меню macOS, трей Windows, отчеты в HTML
Tokdash показывает расход токенов и стоимость сессий Claude Code, Codex, Gemini CLI и еще десятка агентов локально
Коротко о README
README объясняет, зачем считать расходы агентов по веткам, дает установку, правила расчета с тремя видами сумм (billed, estimated, unpriced), замеры скорости, список команд и поддерживаемых агентов.