Token-Goat CLI
Token-Goat режет повторные чтения файлов, шум сборок и тяжелые скриншоты до того, как они попадут в контекст агента.
- 148 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки перехватывают чтение файлов и вывод команд и меняют то, что получает модель.
- Установка правит конфигурацию агента и создает локальный индекс проекта.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/token-goatОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки перехватывают чтение файлов и вывод команд и меняют то, что получает модель.
- Установка правит конфигурацию агента и создает локальный индекс проекта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Token-Goat ставит хуки в Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, Windsurf и другие агенты и сокращает расход токенов без смены привычек. Повторное чтение файла заменяется подсказкой с узким срезом, вывод `pytest`, `npm install` или `docker build` сжимается до ошибок, скриншот уменьшается до сотни килобайт. PDF, Office-файлы и CSV перехватываются: модель получает структуру, а не весь файл. Команды `token-goat read "file::symbol"` и `token-goat brief` отдают одну функцию с вызывающими местами вместо чтения файла по частям. Перед компактированием сессии в нее добавляется манифест правленых файлов и ключевых символов. Тот же набор работает как MCP-сервер по stdio командой `token-goat mcp-serve`. Содержимое страниц и результатов инструментов оборачивается в рамку недоверенного текста против инъекций в промпт.
Для кого. Разработчики с длинными сессиями в Claude Code или Codex, которых беспокоят счета за токены и потеря контекста после компактирования.
Подходит, если
- Сессии тянутся часами, а агент снова читает одни и те же файлы.
- Сборки и тесты заливают контекст прогресс-барами и списками пройденных тестов.
- Скриншоты и PDF весят мегабайты и съедают окно модели.
- Нужен один набор правил экономии для нескольких агентов сразу.
Не подходит, если
- Агент работает в режиме без хуков, а MCP-режима хватает не для всех сценариев.
- Проект коммерческий: лицензия PolyForm Noncommercial запрещает коммерческое использование.
- Каждый байт вывода команды нужен модели без сжатия.
Пример запроса к агенту
Покажи тело функции `parseConfig` из `src/config.ts` вместе с вызывающими местами, не читая файл целиком.Ограничения
Лицензия PolyForm Noncommercial: для коммерческой работы нужно отдельное разрешение автора. В README macOS помечена как непроверенная, основные платформы там Windows и Linux, включая WSL. Нужен Node.js. Хуки меняют то, что видит модель, поэтому при отладке странного поведения агента отключайте сжатие переменной `TOKEN_GOAT_BASH_COMPRESS=0`. Цифры экономии в README авторские, измеряйте на своих сессиях командой `token-goat stats`.
Как отключить. Отключите хуки и записи в конфигах агентов по инструкции раздела о безопасности и удалении в `docs/security.md`, затем выполните `npm uninstall -g token-goat`. Индекс и кэш в каталоге данных удаляются отдельно.
Частые вопросы
Что устанавливается на машину?
Хуки и блок инструкций в конфигах агента, индекс, кэш и модели в каталоге данных. Полный список лежит в `docs/install.md` в разделе «What gets installed».
Как подключить к Cursor?
Выполните `token-goat install --cursor`: сервер регистрируется в `~/.cursor/mcp.json`. Параметр `-p` записывает его в проект.
Какие MCP-инструменты включены по умолчанию?
Семь: `symbol`, `read`, `section`, `outline`, `semantic`, `refs` и `retrieve_text`. Остальные включаются списком в `TOKEN_GOAT_MCP_TOOLS`.
Как выключить сжатие вывода команд?
Задайте `TOKEN_GOAT_BASH_COMPRESS=0`. Вывод по-прежнему кэшируется, поэтому `bash-output` продолжает работать.
Под какой лицензией распространяется?
PolyForm Noncommercial. Некоммерческое использование разрешено, для коммерческой работы нужно разрешение автора.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыToken-Saver сжимает вывод терминала для Claude Code: тесты, сборки, диффы и логи контейнеров. Сжатие идет локально.
Claude Token Optimizer — меньше токенов на старте
Claude Token Optimizer
Утилита cto считает токены, которые Claude Code загружает на старте сессии, и сокращает CLAUDE.md до короткой шпаргалки.
Локальный поиск по коду для агентов: находит нужные файлы и фрагменты и держит контекст в пределах заданного бюджета токенов
CLI-прокси на Go: сжимает вывод git, тестов и сборки до того, как он попадет в контекст агента, фильтрами на YAML. Экономия токенов по оценке автора 60–90%
Локальная панель токенов, стоимости и вызовов инструментов для Claude Code, Codex, Gemini CLI и других агентов.
Token Router достает из больших логов и Python-файлов нужные исходные строки, чтобы модель читала меньше и без пересказов.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Token-Goat (эта карточка) | нет | 148 | ||
| Token Optimizer | нет | 2 964 | плагин оптимизации токенов; Token-Goat работает хуками в нескольких агентах и сжимает вывод более 150 CLI | |
| TokenSave | да | не нужна | 704 | MCP-сервер; здесь еще перехват чтений, сжатие вывода и манифест для компактирования |
Коротко о README
Установка записывает хуки и блок с маршрутизацией команд в инструкции агента, а агент сам выбирает нужную команду: точечное чтение, поиск, карту репозитория или возврат уже полученного вывода.