Что это
Headroom — библиотека и прокси-сервер с открытым кодом, который сжимает всё, что читает AI-агент: результаты вызова инструментов, логи сборок и тестов, чтение файлов, RAG-выдачу, ответы API. Система автоматически подбирает компрессор под тип данных: SmartCrusher для JSON, CodeCompressor для кода на основе AST, отдельная нейросетевая модель Kompress-v2-base для текста. Сжатие обратимо: исходные данные кэшируются, и модель может запросить полную версию при необходимости. Есть режим headroom learn, который разбирает неудачные сессии агента и сохраняет правки на будущее.
Для участников клуба, которые гоняют агентов вроде Claude Code, Cursor, Aider, Codex CLI или собирают своих через LangChain/LiteLLM, Headroom снижает счёт за токены без переписывания промптов — достаточно поставить прокси или обернуть вызовы функцией compress(). Полезен и для вайб-кодеров, у которых агент упирается в лимит контекста на больших логах и диффах, и для тех, кто строит RAG-пайплайны и хочет ужать чанки перед отправкой в модель.
Проект поддерживает интеграции с Claude Code, Codex, Cursor, Cline, Continue, Goose, OpenHands и MCP-серверами, то есть встраивается в уже существующий стек без смены инструментов.
Возможности
- Прокси-режим без изменения кода агента и SDK на Python/TypeScript с функцией compress()
- Автоматический выбор компрессора: SmartCrusher для JSON, CodeCompressor для кода по AST, нейросеть для текста
- Обратимое сжатие (CCR) — модель может запросить исходные данные из кэша при необходимости
- Экономия по типам контента: логи сборок и тестов 80-95%, JSON 70-90%, поиск кода до 92%
- Кроссагентная память — общее хранилище контекста между Claude, OpenAI, Gemini и другими моделями
- Функция headroom learn — анализ неудачных сессий агента и сохранение корректировок
- Готовые интеграции с LangChain, Agno, Strands, LiteLLM, Vercel AI SDK и MCP
- Поддержка популярных coding-агентов: Claude Code, Codex CLI, Cursor, Aider, Copilot CLI, Cline, Continue, Goose, OpenHands
Цена: Основной движок Headroom с открытым кодом (Apache 2.0), устанавливается через pip, бесплатен для самостоятельного развёртывания. Отдельно существует платное macOS-приложение (extraheadroom.com) с готовой обёрткой, автообновлениями и поддержкой — но это надстройка над тем же open-source ядром, а не тарифы самого репозитория.
