Быстрые результаты
Убрать токены схем за 5 минут: scan → mcp lazy
Разделить затянувшийся чат: chats drift → chats compact
Поставить лимит расходов: budget set → CI-гейт
Быстрый старт
git clone <repo> tokenguard && cd tokenguard
npm install
node bin/tokenguard.js scan
node bin/tokenguard.js mcp audit --probe
node bin/tokenguard.js chats list
node bin/tokenguard.js docs index --writeСправочник команд
Справочник CLI оставлен на английском, чтобы совпадать с --help и исходниками. Названия команд и флаги одинаковы во всех локалях.
tokenguard scan Сводка: харнессы, чаты, MCP, мёртвые проекты, проблемы docs tokenguard chats list Список чатов с размерами и токенами tokenguard chats digest <id> Авто-конспект чата (без LLM): запросы, файлы, команды tokenguard chats rename <id> "Название" Переименовать чат по смыслу (штатным событием session/title) tokenguard chats archive <id> Архивировать/удалить чат с tar-бэкапом tokenguard chats clean --older-than 30 Найти и убрать старые чаты tokenguard chats drift [--all] Детектор смены темы: где разговор ушёл в сторону и где выгодно начать новый чат (с оценкой сэкономленных токенов) tokenguard chats compact <id> Сжать старую часть чата в конспект и продолжить в новом чате tokenguard chats tools <id> Повторные одинаковые tool-вызовы: сколько раз и сколько токенов впустую tokenguard report [--days 7] Профайлер токенов: по дням, сессиям и инструментам, с оценкой стоимости tokenguard budget set/status/check Дневной/недельный бюджет токенов и контроль перерасхода tokenguard guard install/status/check Правило экономии контекста в AGENTS.md и проверка дрейфа темы tokenguard artifacts list Что создал tokenguard: бэкапы, конспекты, lazy-прокси, архивы tokenguard artifacts clean --all Безопасно удалить артефакты tokenguard (dry-run по умолчанию) tokenguard mcp audit [--probe] Найти MCP-конфиги, посчитать инструменты и токены их схем, показать использование tokenguard mcp lazy <server> Сгенерировать ленивый прокси: 2 инструмента вместо всех, запуск по требованию tokenguard mcp lazy --all [--apply] [--apply-dsh] Перевести в ленивый режим все stdio-серверы; --apply-dsh — точечно патчит профиль DSH tokenguard projects scan Мёртвые/незавершённые проекты по git-метрикам tokenguard projects archive <path> git bundle + tar + опись, опционально перенос в архив tokenguard docs index Построить INDEX.md: заголовки, описания, дубли, осиротевшие, устаревшие tokenguard docs check Битые ссылки, противоречащие значения (порты/версии), дубли текста, устаревшие «актуально на» Принципы безопасности
- Dry-run по умолчанию. Изменения только с --apply.
- Бэкап перед изменением. Всё сохраняется в ~/.tokenguard/backups.
- Живые сессии не трогаются. Если файл сессии изменён <2 минут назад — нужен --force.
- Никакой сети без флагов. Конспекты строятся локально, без LLM.
- Честные эвристики. docs check — не «истина в последней инстанции», а подсказки;
Ленивый MCP на практике
node bin/tokenguard.js mcp lazy safari --probeGitHub · Changelog Changelog →