Tokless CLI
CLI-установщик восьми инструментов экономии токенов: правила, хуки, MCP и локальный прокси для Claude Code, Codex, Cursor.
- 370 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Скрипт из сети правит конфигурацию нескольких агентов, ставит хуки на команды и локальный прокси для трафика к моделям.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/HoangP8/tokless/main/scripts/install.sh | bashПервая команда раздела Manual для macOS и Linux. Для Windows в README есть вариант PowerShell. Скрипт стоит прочитать до запуска.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Скрипт из сети правит конфигурацию нескольких агентов, ставит хуки на команды и локальный прокси для трафика к моделям.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Tokless ставит и настраивает набор из восьми проектов: `principles`, `ponytail`, `caveman`, `rtk`, `headroom`, `codegraph`, `context-mode` и `projectmem`. Каждый подключается подходящим для агента способом: блок инструкций, хук на команды Bash, плагин, MCP-сервер или локальный HTTP-прокси. Из 29 инструментов трех MCP-серверов в контекст попадают 12: остальные Tokless отсекает ограничивающим прокси. Режим работы задают флаги `--agents` и `--tools`, а `tokless doctor` показывает состояние инструментов, агентов и маршрутов.
Для кого. Тем, кто работает сразу с несколькими агентами (Claude Code, Codex, Cursor, Cline) и устал собирать экономию токенов из разрозненных пакетов вручную.
Подходит, если
- Новая машина или новый агент: нужно за минуты получить индекс кода, сжатие вывода и память проекта.
- Длинные логи и крупные файлы забивают контекст, а `context-mode` держит их вне него.
- Несколько агентов на одной машине должны получать одинаковые правила и один набор MCP-инструментов.
- Перед изменением конфигурации проверяют результат флагом `--dry-run`, ничего не записывая.
Не подходит, если
- Конфигурация агента собрана вручную и защищена от изменений: установщик правит файлы нескольких агентов.
- Запрещено запускать скрипты из сети через `curl | bash`.
- Нужен один конкретный инструмент из набора: его проще поставить самостоятельно.
Пример запроса к агенту
Покажи, какие файлы изменит Tokless для Claude Code и Codex, выполнив `tokless --dry-run --agents claude,codex`, и опиши записи.Ограничения
Установщик меняет конфигурацию агентов: добавляет блоки инструкций, хуки, плагины, записи MCP и локальный прокси `headroom` на `127.0.0.1:8787`, который сжимает запросы к моделям и маршрутизирует трафик. Прокси по умолчанию запускается при входе в систему (`tokless proxy autostart off` отключает). Основная команда выполняет скрипт из сети через `curl | bash`, поэтому сначала прочитайте `scripts/install.sh`. Репозиторий объединяет сторонние проекты, их поведение и лицензии определяют их авторы.
Как отключить. Выполните `tokless disable --agents claude`, чтобы отключить выбранных агентов и сохранить инструменты, либо `tokless uninstall` для полного удаления вместе с бинарными файлами. Остановить прокси можно командой `tokless proxy down`.
Частые вопросы
Какие инструменты входят в набор?
Восемь: `principles`, `ponytail`, `caveman`, `rtk`, `headroom`, `codegraph`, `context-mode` и `projectmem`. Ограничивайте набор флагом `--tools`, например `--tools rtk,codegraph`.
Какие агенты поддерживаются?
Среди идентификаторов в README `claude`, `codex`, `cursor`, `cline`, `copilot`, `opencode`, `antigravity`, `amp` и другие. Выбор делает флаг `--agents`.
Как посмотреть, что будет изменено?
Запустите `tokless --dry-run`: он показывает все записи и ничего не меняет. Состояние после установки показывает `tokless doctor`.
Как обновить инструменты?
`tokless update` обновляет CLI и все инструменты, `tokless self-update` обновляет только бинарный файл Tokless.
Что делает прокси headroom?
Он сжимает большие запросы и маршрутизирует трафик к моделям с вашими ключами. Управляют им командой `tokless proxy up`, `down` или `status`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыToken Savior индексирует код по символам, хранит память между сессиями и переписывает шумные команды Bash, чтобы агент тратил меньше токенов
Установщик набора из хуков, команд и плагинов, который сжимает вывод инструментов и экономит токены в Claude Code.
tokendoctor показывает, где Claude Code переплачивает токенами, советует правки настроек и откатывает их одной командой
Локальный прокси с панелью в терминале: показывает, сколько токенов уходит с каждым запросом Claude Code и Codex, и сохраняет промпты в файлы
Token Optimizer MCP
token-optimizer-mcp
Сжатие и кэш контекста, учет экономии токенов по агентам. Глобальная установка npm включает хуки Claude и оборачивает команды; телеметрия по умолчанию выключена
CLI на Python без зависимостей: один каталог MCP-серверов и скиллов для всех агентов, в контекст попадает краткий индекс
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Tokless (эта карточка) | нет | 370 | |
| RTK | нет | 86 384 | сжимает вывод команд для агента; Tokless устанавливает rtk вместе с остальными инструментами и подключает его к нескольким агентам |
| Caveman | нет | 119 208 | задает краткий стиль ответов; в Tokless это один из восьми подключаемых инструментов |
Коротко о README
Работа Tokless описана как подключение, а не как запуск: после установки инструменты действуют сами. Таблица в README показывает, каким способом каждый из восьми инструментов подключается к каждому агенту.