# RTK-AI Token Saver

> Подключите к ней агента — вывод его git, ls, grep и тестов вернётся сжатым: меньше токенов, те же факты.

Source: https://docs.neurosquad.ai/ru/plugins/rtk-ai-token-saver

Агенты читают много вывода команд: каждый `git status`, `git log`, список файлов и прогон тестов
попадает в их контекст. Плагин **RTK-AI Token Saver** пропускает команды оболочки агента через
[RTK](https://github.com/rtk-ai/rtk) — открытый инструмент, который оставляет факты и убирает шум:
`git status` превращается в компактный список изменённых файлов, прошедшие тесты — в одну строку.

## Как пользоваться

1. В меню добавления карточек выберите **Плагины**, откройте **RTK-AI Token Saver** на вкладке
**Плагины** и нажмите **Добавить на канвас**.
2. Если RTK не установлен, нажмите **Скачать RTK**. NeuroSquad скачает официальную сборку с GitHub
(около 4,5 МБ) и сверит её с контрольной суммой, которую публикует GitHub; без контрольной суммы
скачивание не выполняется. RTK уже стоит (`winget install rtk-ai.rtk`, `brew install rtk`)? Он
найдётся сам.
3. Проведите [стрелку](https://docs.neurosquad.ai/ru/canvas/arrows) от агента к карточке.

Всё — уже **следующая** команда агента идёт через RTK. Без перезапуска. Уберите стрелку — и
следующая команда снова выполнится как обычно.

## Что показывает карточка

- **Насколько меньше вывода** читают подключённые агенты — в процентах — и примерно сколько токенов
это сэкономило.
- Каждого подключённого агента: его экономию и последнюю сжатую команду, например
`git status → rtk git status`.
- Какая версия RTK используется — ваша установка или скачанная.

Каждая сжатая команда вспыхивает на стрелке и попадает в журнал стрелки.

> RTK считает токены как байты ÷ 4: процент точный, число токенов — приблизительное. RTK сжимает
> только вывод команд оболочки — ваши промпты, чтение файлов самим агентом и его ответы не меняются.

## С какими агентами работает

Вживую — с **Claude Code**, **Cursor CLI**, **OpenCode**, **Kilo Code**, **MiMo Code** и **ZCode**. Других агентов подключить
можно, но карточка пометит их **Не поддерживается**: их CLI пока не дают переписать команду до
запуска.

- **Опасный режим** — сжимается каждая поддерживаемая команда.
- **Обычный режим (Claude Code)** — команды только для чтения (`git status`, `git log`, `ls`, `cat`,
`grep`) сжимаются без запроса, как и выполнялись раньше. Команды, которые и так спросили бы
(`git push`, `cargo test`…), спрашивают один раз — вы разрешаете `rtk`-версию. Остальное
выполняется без изменений. RTK не добавляет запросов и не разрешает то, что спросило бы.
- **Обычный режим (Cursor, OpenCode, Kilo, MiMo Code, ZCode)** — их запросы разрешений нельзя предсказать снаружи,
поэтому для них RTK работает только в опасном режиме.
- **Режим карточек** — у агента нет своей оболочки, сжимать нечего.

Если RTK нет, он упал или не знает команду — выполняется исходная команда без изменений. Агенту,
которому нужен полный вывод одной команды, достаточно запустить её с `RTK_DISABLED=1` впереди.

## Приватность

RTK работает на вашем компьютере. NeuroSquad выключает собственную (добровольную) телеметрию RTK у
каждого агента, которого запускает, и хранит историю RTK отдельно для каждого агента в папке данных
NeuroSquad. Ваши настройки RTK остаются как есть.

RTK создан rtk-ai и распространяется по лицензии Apache 2.0.
