Arcanada — Coworker v0.3.0 — RTK plugin: 60–90% экономия prompt-токенов на shell-output

Мы выпустили coworker v0.3.0 — опциональный плагин Rust Token Killer (RTK) для Claude Code.

Четыре новых подкоманды: coworker rtk install, enable, disable, status. Никаких сломанных изменений — ask, write, stats, debug работают как раньше. Плагин выключен по умолчанию.

Зачем это нужно

Две независимые статьи расхода токенов:

Coworker делегирует чтение файлов дешёвой LLM. Вы не платите Opus за чтение 600-строчных файлов. Экономия — порядок.
RTK фильтрует stdout git, pytest, find, docker logs на локальной машине, сжимая шум на 60–90% перед отправкой в LLM.

Вместе закрывают обе статьи. Один инструмент — I/O. Второй — shell-шум.

Что появилось

Команда	Что делает
`coworker rtk install`	Печатает инструкции по установке бинарника rtk для вашей ОС (macOS/Linux/Windows).
`coworker rtk enable`	Добавляет маркированный hook-блок в `~/.claude/settings.json`.
`coworker rtk disable`	Удаляет только маркированный блок; остальные hook'и нетронуты.
`coworker rtk status`	Показывает путь к rtk, версию, статус hook'а.

Плагин не устанавливает бинарник. Вы устанавливаете RTK самостоятельно — brew install rtk, cargo install, или curl-скрипт. Плагин только управляет hook'ом.

Идемпотентность hook'а

enable добавляет блок с маркером _managed_by: "coworker-rtk". Повторные вызовы не плодят дубликаты — блок появляется ровно один раз. disable ищет только этот маркер.

{
  "matcher": "Bash",
  "hooks": [
    {
      "type": "command",
      "command": "rtk hook claude",
      "_managed_by": "coworker-rtk",
      "_version": 1
    }
  ]
}

Запись атомарная — tempfile + os.replace. Если редактор с автосохранением вклинится, повторный enable восстановит целостность.

Если у вас уже есть coworker-hook-guard в settings.json — RTK-блок добавляется рядом, не переписывая существующее. Guard и RTK работают последовательно: guard проверяет, RTK сжимает вывод.

Цифры benchmark

Бенчмарк гибридный: синтетический корпус (типовой stdout команд) + live-API вызовы к Moonshot и DeepSeek. Медиана по N=5 повторам для воспроизводимости ±5 п.п. Реальные числа с live-прогона по двум провайдерам:

Команда	Токенов до	Токенов после	Дельта
`pytest` (30 passed) — Moonshot	649	50	−92.3%
`git log --stat` (5 commits) — Moonshot	478	91	−81.0%
`ruff check` (90 errors) — Moonshot	1958	813	−58.5%
`find` (50 файлов) — Moonshot	593	358	−39.6%
`docker logs` (с трейсом) — Moonshot	1049	1049	0.0%
`pytest` — DeepSeek	649	54	−91.7%
`ruff check` — DeepSeek	2076	859	−58.6%

Два запуска подряд с одним корпусом дали identical delta_% на всех строках (0.0 п.п. drift) — значительно лучше критерия ±5 п.п. docker logs с 0% — крайний случай: RTK не имеет специализированного фильтра для произвольного app-логирования и возвращает passthrough. Это честный показатель — для шумного pytest / git / ruff экономия 60–97%, для нестандартного output её может не быть. Бенчмарк не маркетинг, а инструмент диагностики.

Воспроизвести на своих ключах:

RUN_LIVE_TESTS=1 MOONSHOT_API_KEY=... DEEPSEEK_API_KEY=... \
  python3 scripts/bench_rtk.py --output ./bench.md

Quick start

macOS:

brew install rtk
coworker rtk enable
coworker rtk status

Linux:

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | sh
coworker rtk enable
coworker rtk status

Windows: скачать rtk-x86_64-pc-windows-msvc.zip с releases, распаковать в папку на PATH, затем запустить coworker rtk enable и coworker rtk status.

После enable — перезапустите Claude Code, чтобы hook загрузился.

Совместимость

v0.3.0 — additive minor release. Никакого сломанного поведения. Если вы уже используете coworker ask / write / stats / debug, просто обновитесь:

pipx upgrade coworker
# или:
pip install --upgrade git+https://github.com/Arcanada-one/coworker

RTK plugin default-off. Если не трогать rtk subcommand — ничего не изменится.

Ссылки

Жизнь одного человека имеет значение.