# usage-engineer

Плагин usage-engineer для Claude Code и Codex считает расход токенов в сессиях, сжимает длинные логи и проверяет актуальность карты проекта. Он также выявляет повторные сбои команд.

- плагин · `type=plugin` · Claude Code, Codex · ★ 1596 у репозитория
- Автор: noamshorts22-prog
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/noamshorts22-prog/usage-engineer
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 3 файла скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/usage-engineer

## Что делает

\`ue` — локальный CLI из одного файла Python. Зависимостей нет, в сеть он не ходит. Задача простая: показать, сколько работы агент выбрасывает зря — гигантские логи в контексте, повторные запуски той же падающей команды, карты проекта, которые разошлись с деревом файлов.

\`audit` собирает расход из локальных Codex rollout JSONL, транскриптов Claude и базы OpenCode, с `--by-day` даёт таблицу по дням. `summarize-log --file build.log` оставляет в логе каждую строку с ошибкой и контекст, а байт-в-байт оригинал кладёт рядом и печатает путь. `map build` и `map check` версионируют снимок проекта: `check` выходит с кодом 1 и перечисляет изменившиеся файлы. Всё, что пишет на диск, включается флагом — `apply-profile --target codex` делает бэкап и запись SHA-256, а `rollback` откажется затирать правки, сделанные после apply (код 3).

Аудит не открывает `auth.json`, куки и текст переписки, домашний каталог подменяет на `%HOME%`. Живой бенчмарк без `--max-calls` и `--confirm` не стартует: потолок там по числу вызовов, токены и деньги он не ограничивает. В опубликованном первом прогоне подготовленный пакет контекста на трёх кейсах, где оба варианта прошли, съел на 30% больше токенов. `ue` этого и не скрывает.

## Установка

### Claude Code (родная платформа)

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
В чате агента (не в терминале):
```text
/plugin install usage-engineer@awesome-codex-plugins
```

## Когда брать
- сжать лог сборки до ошибок и контекста, сохранив оригинал
- найти, в какие дни расход токенов в Codex вырос
- поймать устаревшую карту проекта перед возобновлением работы
- вычистить дублирующиеся правила из `AGENTS.md`
- сравнить два прогона бенчмарка и увидеть регрессии качества

## Примеры запросов агенту
- Прогони `ue audit --by-day` и скажи, в какие дни расход токенов вырос.
- Сожми `build.log` командой `ue summarize-log --file build.log`, оригинал не трогай.
- Проверь карту проекта через `ue map check`, и если она устарела — пересобери.

## Похожие
- [01-usage](https://affpapa.org/nevibecode/skills/01-usage.md) — скилл · ★ 571 у репозитория
- [claude-usage-analyst](https://affpapa.org/nevibecode/skills/claude-usage-analyst.md) — скилл · 471 установка
- [usage-trends](https://affpapa.org/nevibecode/skills/usage-trends.md) — скилл · ★ 1198 у репозитория
- [huawei-cloud-maas-tokens-usage](https://affpapa.org/nevibecode/skills/huawei-cloud-maas-tokens-usage.md) — скилл · 207 установок
- [LatentGate](https://affpapa.org/nevibecode/mcp/latentgate.md) — MCP-сервер · ★ 25 у репозитория
- [opencli-usage](https://affpapa.org/nevibecode/skills/opencli-usage.md) — скилл · 21600 установок

Из того же набора: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
