headroom

Слой сжатия контекста для AI-агентов: сжимает выводы инструментов, логи, RAG-фрагменты, файлы и историю диалога.

HLHeadroom Labs Локальный Память и знания ★ 74.5k

Что это

Слой сжатия контекста для AI-агентов: сжимает выводы инструментов, логи, RAG-фрагменты, файлы и историю диалога.

Как подключить

1Установить и запустить в терминале
headroom mcp install
2Добавить в конфиг MCP-клиента (mcp.json / claude_desktop_config.json)
{ "mcpServers": { "headroom": { "command": "headroom", "args": [ "mcp", "install" ] } } }

Вставьте блок в конфиг клиента (Claude Desktop, Claude Code, Cursor, VS Code, Cline). Команда и package собраны из полей официального MCP Registry.

Что нового в версиях

v0.40.06 октября 2026 г.Ломает совместимость

Важные изменения: лицензирование, отказ от crewai, сжатие, метрики CO2, Unix-сокеты и исправления бэкендов.

  • Ломает совместимостьЧтение HEADROOM_LICENSE и перевод отчётов об использовании в режим opt-in.
  • Ломает совместимостьУдалён extra crewai для исключения chromadb из lock-файла.
  • НовоеДобавлена диагностика сжатия сообщений и режим densify для live-agent.
  • НовоеВ дашборд и API добавлена карточка CO2 Saved и унифицированы метрики экономии.
  • НовоеПрокси теперь поддерживает Unix domain сокеты, заголовок x-headroom-keep-lasts и маршрутизацию Gemini через нативные трансформы.
  • ИсправленоИсправлены ошибки в бэкендах: сохранение CCR, маппинг tool_choice, синхронизация токенов и обработка статусов 4xx.
v0.39.126 сентября 2026 г.

Исправлена критическая ошибка в прокси, из-за которой запросы с большим контекстом бесконечно отклонялись.

  • ИсправленоУстранена ошибка в прокси, из-за которой лимитер TPM навсегда блокировал запросы с большим контекстом.
v0.39.025 сентября 2026 г.

Релиз v0.39.0: улучшена прозрачность сжатия, добавлено защита сообщений и поддержка контекста 1M в VS Code.

  • НовоеСжатие CCR теперь описывает, какие данные были удалены, а не только объем экономии.
  • НовоеДобавлен хук protect_messages для жесткого запрета сжатия отдельных сообщений.
  • НовоеРасширена поддержка VS Code Claude: теперь доступен контекст объемом 1 млн токенов.
  • НовоеУлучшена аналитика экономии: отслеживание стоимости кэша, новых запросов и общих расходов.
  • ИсправленоИсправлена потеря изображений в запросах через LiteLLM и ошибки кэширования Google.
  • ИсправленоУстранены ложные предупреждения сжатия и проблемы с блокировкой при загрузке бинарников.
v0.38.021 сентября 2026 г.

Обновление v0.38.0: улучшена маршрутизация, сжатие и кэширование, добавлена поддержка OpenAI Responses и новые метрики в дашборде.

  • НовоеBeacon schema v2: новые сигналы для маршрутизации и обучения, а также транспорт с gzip-сжатием.
  • НовоеПрокси теперь принимает формат OpenAI Responses на этапе взаимодействия (turn).
  • НовоеДашборд: новые карточки с экономией, отображение сбережений от маршрутизации и точная атрибуция затрат.
  • НовоеМаршрутизатор: добавлено условие require_tools и улучшена обработка плотных машинных строк.
  • ИсправленоИсправлено сжатие блоков cache_control, сохранение управляющих конструкций Bash и корректная обработка кэша.
v0.37.027 августа 2026 г.

Релиз v0.37.0: унификация сжатия, защита от SSRF, исправления маршрутизации и безопасности прокси.

  • НовоеУнификация движка сжатия для прокси и сайдкар-режима, добавлен /v1/compress и ретрансляция /v1/usage.
  • НовоеВнедрено саморегулируемое состояние сессии для реестра кэша сжатия.
  • ИсправленоЗакрыта уязвимость SSRF в Vertex через валидацию региона и усилен контроль токенов в WebSocket.
  • ИсправленоИсправлена маршрутизация Kimi Code, сохранено нативное распределение моделей Copilot Enterprise.
  • ИсправленоУстранены ошибки сжатия, конфликты настроек и проблемы с очисткой кэша на Windows.
v0.36.522 августа 2026 г.

Исправлено определение авторизации ChatGPT и ложное срабатывание диагностики маршрутизации Claude.

  • ИсправленоИсправлено определение авторизации ChatGPT через id_token claims, теперь корректно инициируется запрос openai_auth.
  • ИсправленоИсправлена диагностика doctor: теперь корректно отображается маршрутизация Claude в рамках проекта вместо ложного отрицания.
v0.36.422 августа 2026 г.

Исправление безопасности, стабильности стриминга OpenAI и настройка бюджетов в Serena.

  • ИсправленоУсилена безопасность: добавлена валидация upstreams, задаваемых пользователем, на всех путях разрешения.
  • ИсправленоИсправлена работа стриминга OpenAI: устранено ошибочное дублирование указателей между ходами.
  • ИсправленоПрокси теперь корректно сохраняет дополнительный инструмент carrier (additional_tools) в ответах.
  • НовоеБюджет простоя предварительной индексации в Serena стал настраиваемым параметром.
  • ИсправленоДля встроенных статических активов зафиксированы MIME-типы в панели управления.
v0.36.221 августа 2026 г.

Исправления в Copilot, Kompress и Proxy; обновление зависимостей ai, tiktoken-rs, tokenizers и TypeScript.

  • ИсправленоCopilot: привязка токена minted к передаваемому ID интеграции.
  • ИсправленоProxy: подсчёт выходных токенов по тексту потока, а не по размеру в сети.
  • ИсправленоKompress: удалённый компрессор теперь принимает ccr_original.
  • НовоеОбновление пакета ai с 6.x до 7.0.59 в SDK и документации.
  • НовоеОбновление TypeScript до 7.0.2 в плагинах openclaw и opencode.
  • НовоеОбновление tiktoken-rs до 0.12.0 и tokenizers до 0.23.1.

Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.