tokenjuice CLI
tokenjuice запускает шумные команды и возвращает агенту короткий детерминированный вывод по JSON-правилам: списки, тесты, сборки
- 543 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Встраивается перед запуском каждой команды агента и пропускает ее вывод через обработчик, ошибка правила может скрыть нужную строку
- Меняет настройки хоста при tokenjuice install и по желанию сохраняет исходный вывод команд на диск
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/tokenjuiceОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Встраивается перед запуском каждой команды агента и пропускает ее вывод через обработчик, ошибка правила может скрыть нужную строку
- Меняет настройки хоста при tokenjuice install и по желанию сохраняет исходный вывод команд на диск
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tokenjuice — консольная программа на Node.js, которая сжимает вывод терминальных команд перед тем, как он попадет в контекст агента. Команда `tokenjuice wrap` запускает другую команду и возвращает уменьшенный вывод, а `tokenjuice reduce` сжимает уже готовый текст, например лог сборки. Правила сжатия описаны в JSON и охватывают перечни файлов, вывод тестов, логи сборки и другой шум. Встроенные правила дополняются слоями из `~/.config/tokenjuice/rules` и `.tokenjuice/rules` проекта, позднее правило по тому же идентификатору побеждает. Сжатие подключается к агентам через интеграции. Для Claude Code команда `tokenjuice install claude-code` ставит обертку перед запуском инструмента, а `tokenjuice doctor claude-code` проверяет управляемую конфигурацию. Для OpenClaw есть внешний плагин, для Hermes, Copilot SDK, LangChain, Mastra и FastMCP есть встроенные адаптеры. Точные чтения файлов хост-интеграции сохраняют без изменений. Упавшие команды остаются целиком: флаг `--keep-failures` сохраняет stdout, stderr и код выхода, а автоматические обертки включают его сами. Флаги `--raw` и `--full` отключают сжатие, а `--store` сохраняет исходный вывод в каталог артефактов.
Для кого. Разработчикам, чьи агенты часто запускают команды с длинным выводом (тесты, сборки, git, pnpm) и тратят контекст и токены на шум.
Подходит, если
- Агент запускает pnpm test, и в контекст попадают сотни строк прошедших тестов
- Логи сборки слишком длинные для контекста и их надо свернуть до ошибок
- В проекте повторяются свои шумные команды, и для них нужны собственные JSON-правила в `.tokenjuice/rules`
- Хочется видеть, сколько вывода сэкономлено: для этого есть `tokenjuice stats`
Не подходит, если
- Вывод команд короткий: сжимать нечего, а обертка добавляет еще один слой
- Агенту нужен побайтно точный вывод: для таких случаев есть `--raw`, но проще не включать обертку
- На машине нет Node.js 22 или новее
Пример запроса к агенту
Подключи tokenjuice к Claude Code и покажи, насколько он сократит вывод pnpm test в этом проектеОграничения
- Нужен Node.js 22 или новее.
- Успешная проверка doctor подтверждает управляемую конфигурацию, но не доказывает, что хост ее загрузил и доставил сжатый вывод. После установки перезапустите хост или начните новую сессию.
- Адаптер OpenClaw сжимает результаты оболочки и не затрагивает результаты Code Mode на JavaScript.
- Захват вывода ограничен 4 МБ по умолчанию, лимит меняется флагом `--max-capture-bytes`. Расширение Pi сохраняет исходные байты каждой замены.
Как отключить. Для Claude Code выполните `tokenjuice uninstall claude-code`: команда снимает управляемую конфигурацию. Саму программу снимает менеджер пакетов, например npm uninstall -g tokenjuice. Телеметрию статистики отключает переменная `TOKENJUICE_STATS=off` или флаг `--no-stats`.
Частые вопросы
Как подключить tokenjuice к Claude Code?
Установите пакет командой `npm install -g tokenjuice`, затем выполните `tokenjuice install claude-code` и проверьте `tokenjuice doctor claude-code`. Перезапустите Claude Code или начните новую сессию. Снять подключение можно командой `tokenjuice uninstall claude-code`.
Что tokenjuice сжимает, а что оставляет как есть?
Сжимаются перечни, вывод тестов и логи сборки по JSON-правилам. Точные чтения файлов через хост-интеграции остаются как есть, упавшие команды сохраняют stdout, stderr и код выхода при включенном `--keep-failures`.
Как получить исходный вывод?
Запустите команду с `--raw`, он отключает сжатие, но соблюдает лимит захвата 4 МБ. Чтобы хранить исходный вывод, добавьте `--store` и задайте каталог в `TOKENJUICE_ARTIFACT_DIR`, затем читайте сохраненное командой `tokenjuice cat`.
Как написать свое правило?
Положите JSON-правило в `~/.config/tokenjuice/rules` или в `.tokenjuice/rules` проекта. Позднее правило с тем же идентификатором перекрывает ранние, а проверить фикстуры можно командой `tokenjuice verify --fixtures`.
Какие агенты и фреймворки поддерживает tokenjuice?
Claude Code через обертку перед запуском инструмента, OpenClaw через внешний плагин, расширение Pi, а также адаптеры для Hermes, Copilot SDK, LangChain, Mastra и FastMCP. Матрица поддержки лежит в docs/adapter-support-matrix.md.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыToken Optimizer
token-optimizer
Плагин для Claude Code и Codex: режет лишние токены, сохраняет работу между сессиями и сжатиями, показывает стоимость. Лицензия некоммерческая
Tokscale
tokscale
CLI с интерактивным TUI для учета расхода токенов и стоимости работы AI-кодинг-агентов: Claude Code, Codex, Copilot, Cursor и других
Локальный прокси на Rust сжимает запросы к API моделей от Claude Code, Codex и Cursor, чтобы платить за меньше токенов
squeez сжимает вывод bash до 95 процентов в хуках семи ИИ-CLI, убирает повторные вызовы и сохраняет точные идентификаторы
Token Monitor
token-monitor
Настольный виджет учета токенов, стоимости и лимитов для 43 и более инструментов: Claude Code, Codex, Cursor, OpenRouter и других, для Windows и macOS
Расход токенов и денег по Claude Code, Gemini CLI, Codex и Cursor в одном отчете: по локальным логам, без сети и ключей.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| tokenjuice (эта карточка) | нет | 543 | |
| RTK | нет | 86 384 | другой инструмент сжатия вывода команд, tokenjuice задает сжатие JSON-правилами со слоями проекта и пользователя |
| Token Optimizer | нет | 2 964 | другой подход к экономии токенов, а tokenjuice сжимает только вывод терминальных команд |
Коротко о README
README начинается с установки через npm, pnpm, yarn и Homebrew, затем ведет к каталогу интеграций и показывает подключение Claude Code и OpenClaw. Ниже список команд, раздел о выводе и хранении исходных данных и перечень страниц документации со спецификацией правил.