Обзор

From docs/ru/overview.md at cc732c3 View on GitHub

rtok — это один бинарник на Rust, который сокращает количество токенов, сжигаемых ИИ-агентом для программирования. Каждый метод сокращения токенов — это плагин за единым трейтом, и к этим плагинам ведут три интерфейса:

ИнтерфейсТочка входа
Хуки Claude Codertok hook <event> — JSON на stdin, JSON на stdout
MCP-серверrtok mcp — read, search, tree, expand, mem_*, инструменты графа
API-проксиrtok proxy — промежуточный узел для ANTHROPIC_BASE_URL / OPENAI_BASE_URL

С чего начать

  • Начало работы — установите бинарник и выполните первую команду.
  • Команды — каждая подкоманда и то, что она делает сегодня.
  • Плагины — десять встроенных плагинов и интерфейсы, которые они обслуживают.
  • Конфигурация — один файл, многоуровневый приоритет, полный справочник ключей.
  • Сравнение — против rtk, lean-ctx, headroom, serena и остальных — с доказательствами.

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

Типичная настройка Claude Code нагромождает несколько инструментов, каждый из которых сжимает вывод Bash, кеширует чтения и внедряет контекст при старте сессии, — и каждый заявляет экономию 60–95 %, которую никто не измеряет от начала до конца. При измерении такой набор экономит 3–40 % и стоит примерно 3 K внедрённых токенов за ход.

rtok заменяет этот набор одним бинарником, который работает как один хук на событие, предоставляет одиннадцать MCP-инструментов за ~143 токена описаний на ход вместо ~8 600 на девять серверов, стоит одним промежуточным узлом прокси, который записывает реальный usage, и ведёт одну таблицу измерений, чтобы rtok stats мог сказать, что на самом деле изменилось. Полный разбор по каждому инструменту, включая то, где rtok отстаёт, — в Сравнении.

Каждый плагин написан с нуля в этом репозитории. rtok никогда не запускает, не линкует и не читает инструменты, которые он заменяет.