caveman - Caveman: короткие ответы агента ради лимитов

Когда звать

• Когда лимит Claude Code или Codex кончается к обеду, а половина ответа агента - вступления, пересказ и «с удовольствием помогу».
• Когда агент часами читает логи, вывод тестов и большие JSON, и хочется, чтобы на это уходило меньше токенов.

Что это

Caveman («пещерный человек») - открытый проект Julius Brussee про экономию токенов. Идея шуточная: агент говорит как пещерный человек - без вступлений, вежливостей и пересказа. Но работает всерьёз: у репозитория больше 100 тысяч звёзд на GitHub, последние правки - сентябрь 2026 года.

В проекте две части, и ставятся они отдельно.

• Скилл - текстовые правила для агента: отвечай коротко, без воды. Сокращает то, что агент пишет. Бесплатный, лицензия MIT, работает в Claude Code, Codex и ещё трёх десятках программ.
• Программа-прокладка (прокси) - встаёт между агентом и Anthropic или OpenAI у тебя на компьютере и сжимает то, что агент читает: логи, вывод тестов, JSON, диффы, результаты поиска. Ставится отдельно через npm.

Автор README советует начинать со скилла, а прокладку ставить потом, если захочется большего.

Как это выглядит

Обычный агент на вопрос «почему компонент перерисовывается» пишет абзац на 69 токенов: «Причина, скорее всего, в том, что вы создаёте новый объект при каждой отрисовке…». С caveman ответ тот же по смыслу, но в 19 токенов: «Новый объект каждую отрисовку. Оберни в useMemo».

Код, команды, пути к файлам и тексты ошибок скилл не трогает, сжимает только слова вокруг. Предупреждения о безопасности и вопросы «точно удалить?» агент пишет полными фразами, потом возвращается к короткому стилю. Отвечает на твоём языке: по-русски спросил - по-русски коротко и ответит.

Как поставить скилл

Команды сверены с README и INSTALL.md репозитория на 28 сентября 2026 года.

Claude Code - плагином, в терминале:

claude plugin marketplace add JuliusBrussee/caveman && claude plugin install caveman@caveman

То же можно сделать внутри Claude Code командами /plugin marketplace add JuliusBrussee/caveman и /plugin install caveman@caveman. Плагин включает короткий режим сам в начале каждой сессии.

Codex:

npx skills add JuliusBrussee/caveman -a codex -g

В Codex режим сам не включается: в сессии набери /caveman.

Сразу во все программы на компьютере автор предлагает одну команду npx skills add JuliusBrussee/caveman -g. Есть ещё полный установщик через curl ... | bash, но его мы не советуем: он сам находит все программы на компьютере и правит их настройки, а скачанный скрипт запускается, не показав себя.

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

• /caveman lite - без воды, но полными предложениями. Для начала самый удобный.
• /caveman или /caveman full - основной режим, рубленые фразы.
• /caveman ultra - совсем коротко.
• stop caveman или normal mode - вернуть обычную речь.
• /caveman-commit - описание коммита в одну строку, /caveman-review - замечания ревью по одному в строку.
• /caveman-compress CLAUDE.md - сжать файл правил проекта, чтобы он меньше весил в каждой сессии. Оригинал сохраняется копией в отдельной папке.

Прокладка (прокси) - вторая часть

Ставится отдельно, нужен Node.js:

npm install -g @caveman-ai/cli && caveman setup --install
caveman claude

Вместо claude можно codex, gemini и другие. После этого агент ходит к Anthropic или OpenAI через прокладку на твоём компьютере (адрес 127.0.0.1:8787), а она ужимает большие куски текста. Полные оригиналы кладёт в базу у тебя на диске, и агент может достать их обратно.

Полезные команды из README: caveman learn - разбирает историю твоих сессий на диске и показывает, куда уходят токены; caveman trial -- claude - сравнивает одну и ту же работу с прокладкой и без; caveman disable claude - выключить прокладку для программы; caveman telemetry off - выключить отправку статистики.

Сколько реально экономит

Автор сам честно приводит цифры, и они скромнее шума вокруг проекта.

• Скилл в обычном чате-вопроснике сокращает ответы примерно вдвое (замер автора).
• В настоящей работе с кодом скилл дал около 8,5% меньше исходящих токенов без потери качества - это заявлено по замеру JetBrains на 86 задачах. Причина: основную часть токенов агент тратит на чтение и код, а не на слова.
• Прокладка на наборе из шести задач автора сократила входящие токены на 33%, все ответы остались верными. Это замер самого автора, сырые данные не опубликованы.
• Правила скилла добавляют около 1000 токенов в каждый запрос. На коротких вопросах в одну строку это может съесть больше, чем сэкономит.

Совет из README: прогони одну и ту же задачу с caveman и без и сравни расход. Если на твоей работе не выигрывает - выключи.

Безопасность

Мы прочитали SKILL.md, хуки плагина для Claude Code и описание безопасности в репозитории (SECURITY.md).

Скилл и плагин для Claude Code:

• Сам скилл - это только текст с правилами, никаких команд он не запускает.
• Плагин ставит два хука. В начале сессии скрипт на Node.js читает правила из SKILL.md и подкладывает их агенту. При каждом твоём сообщении второй скрипт смотрит, не набрал ли ты /caveman ..., и запоминает выбранный режим.
• На диск пишет только маленькие служебные файлы в папке ~/.claude (какой режим включён) и сам удаляет старые. Файл настроек ~/.claude/settings.json только читает: если нет строки состояния, агент один раз предложит её настроить, но без твоего «да» ничего не меняет.
• В сеть хуки не ходят, данные никуда не отправляют.
• /caveman-compress переписывает указанный файл сжатым текстом и для этого вызывает Claude (программу claude или API по твоему ключу, если он задан). Копия оригинала сохраняется, но запускай его только на файлах, которые готов доверить правке.

Прокладка (CLI и прокси):

• Через неё идут все твои запросы к Anthropic или OpenAI вместе с ключом или входом по подписке. По описанию автора, ключ уходит только к выбранному провайдеру, на серверы caveman - нет.
• Оригиналы сжатого текста хранятся в базе ~/.caveman/ccr.db. Там могут оказаться куски кода, логов и даже ключи, если они мелькали в работе. Автор сам просит считать этот файл секретным. Удаление программы эти базы не стирает - папки ~/.caveman/ и ~/.caveman-cloud/ удаляй руками.
• Статистика включена по умолчанию. CLI отправляет на api.caveman.so обезличенные данные: какие команды запускались, сколько токенов прошло и сэкономлено, версия, система. По SECURITY.md тексты запросов, код, пути к файлам и ключи не отправляются. Выключается командой caveman telemetry off или переменной DO_NOT_TRACK=1.
• Лицензия прокладки - BSL 1.1: пользоваться для себя можно бесплатно, но это не полностью открытая лицензия. Перепродавать её как сервис другим людям без договора с автором нельзя.

Вывод: скилл безопасен - это текст и два локальных хука без выхода в сеть. Прокладка - серьёзная программа, через которую идёт вся твоя работа с моделью: ставь её осознанно, сразу выключи статистику и помни про базу с оригиналами на диске. Установку через curl ... | bash лучше пропустить.

Вопросы и ответы

Агент не станет глупее? По замеру JetBrains качество не изменилось. Автор пишет: caveman делает меньше рот, а не мозг. Код и ошибки не сокращаются.

Коммиты и документы тоже будут «пещерными»? Нет. По правилам скилла код, коммиты, документация и тексты для других людей пишутся обычным языком.

Работает с подпиской Claude Pro или Max? Скилл - да, ему всё равно. Прокладка по README пропускает вход по подписке к Anthropic без изменений.

Как удалить? В Claude Code - через меню /plugin. Автор также даёт команду npx -y github:JuliusBrussee/caveman -- --uninstall.

Автор и источник

Проект открытый, чужой. Скилл и CLI под лицензией MIT, прокладка и движок под BSL 1.1. Описание и команды сверены с README, INSTALL.md, SECURITY.md и файлами плагина в репозитории JuliusBrussee/caveman (версия плагина 2.7.0) на 28 сентября 2026 года.