AIKraft Agents

yvgude/lean-ctx

Контролируй, что видит твой ИИ. LeanCTX — это слой контекстной интеллекции для AI-агентов: один локальный бинарник на Rust, который решает, что они читают, запоминает, чему учатся, охраняет, к чему прикасаются, и доказывает, что сохраняют. На 60–90% меньше токенов в чеке. 76 MCP-инструментов, 30+ аг

Агенты⭐ 3 931Rustпоследний релиз: v3.12.2
Открыть на GitHub ↗Сайт проекта ↗

Что это за инструмент

LeanCTX — это локальный слой инженерии контекста на Rust, который работает как прокси между AI-агентом и моделью, сжимая и кэшируя передаваемые данные.

Зачем нужен

Инструмент решает проблему переполнения контекстного окна и высоких затрат на API, сокращая объем передаваемых токенов на 60–90% за счет сжатия системных промптов, истории и результатов инструментов. Он обеспечивает локальное сохранение сессий, что позволяет агентам помнить контекст между чатами и избегать повторной отправки одних и тех же файлов.

Что можно реализовать

  • Снижение стоимости API-запросов в IDE-агентах (Cursor, Claude Code, Copilot) за счет кэширования повторных чтений файлов (~13 токенов вместо ~2000).
  • Сжатие вывода командной строки (например, git status) перед отправкой в LLM для экономии контекстного окна.
  • Поддержание непрерывности контекста сессии между разными сессиями чата без необходимости ручного копирования промптов.
  • Мониторинг расхода токенов и затрат в реальном времени через локальный дашборд с контролем бюджета.

Ключевые возможности

  • Локальная работа: один бинарный файл на Rust, не требующий конфигурации (Zero config).
  • Интеграция с 76 MCP-инструментами и поддержка 30+ AI-агентов.
  • Сжатие запросов с сохранением совместимости с prompt-cache (prompt-cache-safe).
  • Ведение верифицируемого реестра экономии токенов (signed, verifiable savings ledger).
  • Опциональная телеметрия только по согласию пользователя (Opt-in Telemetry).

👤 Кому подойдёт: разработчики, использующие AI-кодинг агенты (Cursor, Claude Code, Copilot, Windsurf, Codex, Gemini), стремящиеся оптимизировать расходы на API и увеличить длину полезных сессий кодирования.

Релизы

v3.12.2majorbreaking
🕐 вчера · релиз на GitHub ↗

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

  • Breaking: Исправлена уязвимость (GHSA-483j-9vcj-2gxx): команды записи теперь строго ограничены проектом, предотвращая запись за его пределы.
  • Added: Восстановлена интеграция с Hive: команды connect и link снова доступны и поддерживаются в автодополнении.
  • Fixed: Исправлено поведение обновлений: сохранена конфигурация MCP, исправлена ошибка сравнения версий для pre-release сборок.
  • Fixed: Исправлена работа поиска в разрешённых директориях и корректное назначение режима governor-mcp для новых установок Claude Code.
v3.12.1majorbreaking
🕐 2 дн назад · релиз на GitHub ↗

Релиз безопасности: закрытый отказ shell-гейта, верификация подписей, изоляция путей и новые правилаGovernor R4.

  • Breaking: Shell-гейт теперь работает по принципу fail-closed: политика больше не меняется из окружения агента, а настройки берутся только из встроенных значений и config.toml.
  • Added: Правило R4 для Governor группирует большой вывод Bash, различающийся только в номерах и временных метках, сохраняя оригинал в архиве.
  • Added: Команда ctx_read теперь поддерживает чтение одного символа по имени и возвращает outline для больших файлов, ограниченный ~1500 токенами.
  • Added: Внедрён Hive-Protocol 2.2: агенты могут проверять результаты задач друг друга, а экземпляры LeanCTX передают исправления фактов в хранилище.
  • Fixed: Изоляция путей (PathJail) теперь по умолчанию ограничена активным проектом, а политики проектов больше не могут отключать защиту для .env и ключей.
v3.12.0majorbreaking
🕐 8 дн назад · релиз на GitHub ↗

Выпуск 3.12.0: представлен локальный Cockpit для управления контекстом, устранены 8 уязвимостей, закрыты облачные сервисы.

  • Added: Добавлен локальный Cockpit — единый интерфейс для контроля затрат, защиты и аудита контекста, устанавливается автоматически.
  • Added: Появились команды импорта документации и истории Git для обогащения контекста знаниями проекта.
  • Fixed: Исправлены 8 уязвимостей безопасности, включая защиту от SSRF и контроль доступа к ключам провайдеров.
  • Breaking: Закрыты облачные сервисы (Personal Cloud, registry) и удалено 36 редко используемых инструментов MCP.
  • Added: Внедрена семантическая поисковая модель potion-code на чистом Rust без зависимости от ONNX Runtime.
v3.11.4patch
🕐 25 дн назад · релиз на GitHub ↗

Исправления: поиск проектов, чтение инструкций, опечатки в путях и аргументах, а также улучшение UX графика экономии токенов.

  • Fixed: Инструменты поиска теперь корректно обрабатывают широкие директории, подставляя путь к проекту.
  • Fixed: Агенты получили доступ на чтение к своим инструкциям и навыкам в стандартных каталогах.
  • Fixed: Добавлена автоподстановка файлов при опечатках в путях и исправлена обработка пробелов в путях.
  • Fixed: Применение правок теперь устойчиво к ошибкам отступов, а также поддерживаются вариации имен аргументов.
  • Added: График экономии токенов в интерфейсе Claude Code теперь отображает данные с точной привязкой ко времени.
v3.11.3minor
🕐 26 дн назад · релиз на GitHub ↗

PathJail по умолчанию открывает домашнюю директорию, улучшена работа GPU-эмбеддингов с CUDA 13 и исправлены ошибки обновлений на Windows.

  • Added: PathJail по умолчанию разрешает чтение и запись во всей домашней директории, сохраняя защиту системных папок.
  • Fixed: Исправлена ошибка установки обновлений на Windows, когда процесс блокировал удаление старого бинарника.
  • Fixed: Эмбеддинги теперь корректно работают с CUDA 13 и улучшена диагностика загрузки GPU-библиотек.
  • Fixed: Улучшено обнаружение Python-окружений и исправлена ошибка 'Transport closed' при частых вызовах шлюза.
v3.11.2patchbreaking
🕐 27 дн назад · релиз на GitHub ↗

Исправление безопасности jail scope и редиректов, а также критических багов обновлятора и докера.

  • Breaking: Jail scope `home` теперь разрешает чтение только файлов внутри проектов с маркерами, блокируя доступ к остальным личным файлам.
  • Breaking: Параметр `redirect_exclude` из ненадёжных рабочих пространств теперь игнорируется, предотвращая обход хуков редиректа.
  • Fixed: Исправлена ошибка обновления, из-за которой процесс прерывался из-за отсутствия дайджеста целостности транзакции.
  • Fixed: Восстановлена возможность возобновления потоков Codex, ранее помеченных как несуществующие из-за удаления провайдера.
  • Fixed: Обновлятор теперь корректно использует токены GitHub для повышения лимита запросов и исправлена ошибка подписи на macOS.
v3.11.1majorbreaking
🕐 28 дн назад · релиз на GitHub ↗

LeanCTX v3.11.1: расширен доступ к файлам, усилены ограничения для агентов, исправлены глобальные привязки проектов.

  • Breaking: Агенты больше не могут менять настройки безопасности через shell; заблокированы команды изменения прав и доверия.
  • Breaking: Новая политика path_jail_scope по умолчанию: чтение доступно во всём домашнем каталоге, но запись ограничена проектом сессии.
  • Added: Добавлена команда lean-ctx allow-path для точечного разрешения доступа к отдельным директориям без перезапуска.
  • Fixed: Исправлено глобальное закрепление проектов в конфигурации MCP; удалены устаревшие привязки.
  • Added: Улучшена телеметрия: теперь передаются данные об окружении и возрасте установки.
v3.11.0majorbreaking
🕐 29 дн назад · релиз на GitHub ↗

v3.11.0: Context Gateway по умолчанию, телеметрия v2, семантика через LSP, индекс v7 и фикс безопасности shell allowlist.

  • Breaking: Context Gateway и телеметрия v2 включены по умолчанию; индекс графа обновлен до версии 7, старые индексы v6 несовместимы.
  • Added: Семантические представления кода используют Language Server Protocol, а Context Store связывает план, доставку и результат задачи.
  • Fixed: Исправлена уязвимость обхода shell allowlist в режимах -c и -t, а также улучшена фильтрация секретов в графовых сводках.
  • Added: Добавлен модуль Claude Code для управления выводом Bash и восстановления контекста, а CLI получил команду lean-ctx index why.
  • Deprecated: Удалена опциональная кэш-память вывода оболочки и автоматическая маршрутизация моделей; оставшиеся настройки игнорируются.
v3.10.5patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлены проблемы с MCP-конфигами после обновлений, поиском в проекте, параллельными вызовами и логами безопасности.

  • Fixed: MCP-конфигурации теперь сохраняются при обновлениях через Scoop, Homebrew, npm и mise.
  • Fixed: ctx_search с query= теперь корректно ищет в проекте текущей сессии, а не только в зафиксированном.
  • Fixed: Исправлено получение ответов при одновременных одинаковых вызовах ctx_shell.
  • Fixed: Предупреждения безопасности (shell_security=warn) теперь логируются корректно, а не как блокировки.
  • Fixed: Исправлен вывод справки lean-ctx serve --help с реальными переносами строк.
v3.10.4patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлены критические баги: зависание терминала через ctx_shell, ошибки путей с пробелами и некорректная работа флага --help.

  • Fixed: Исправлено зависание терминала: ctx_shell теперь запускает команды в отдельной сессии без управляющего терминала.
  • Fixed: Исправлена ошибка выполнения команд при наличии пробелов в пути к бинарному файлу (например, Program Files).
  • Fixed: Флаг --help больше не запускает обновление; неизвестные опции корректно отклоняются с кодом ошибки 2.
  • Fixed: Строка статуса lean-ctx теперь корректно устанавливается для существующих установок Claude Code.
  • Fixed: В OpenCode режим тени теперь запрашивает разрешение (ask) для bash и read вместо отказа (deny).
v3.10.3major
🕐 1 мес назад · релиз на GitHub ↗

lean-ctx v3.10.3: криптографическая верификация экономии токенов, интеграция с Claude Code и уведомления о достижениях.

  • Added: Команда lean-ctx value теперь использует хэш-цепочки для криптографического подтверждения сохраненных токенов и событий безопасности.
  • Added: Внедрена интеграция с Claude Code: статусная строка, рекап сессий и дайджесты выводятся через systemMessage, не попадая в контекст модели.
  • Added: Добавлены уведомления о достижениях (milestones) на рабочем столе и сегменты для промптов в терминалах zsh, fish и bash.
  • Added: Появился git-хук prepare-commit-msg, автоматически добавляющий трейлер с метриками экономии токенов в сообщения коммитов.
  • Added: По умолчанию добавлены подписанные записи в аудит-трейл для скрытых секретов, заблокированных команд и запрещенных путей.
v3.10.2patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлена нестабильность кэша на Windows и добавлен таймаут для предотвращения зависания инструментов MCP.

  • Fixed: Устранена ошибка, при которой временная блокировка файла на Windows приводила к ложному обновлению кэша.
  • Fixed: Добавлено повторное выполнение запросов к файловой системе для обработки кратковременных сбоев.
  • Fixed: Исправлена работа с снимками редактирования, исключая ложные конфликты при временных ошибках чтения.
  • Fixed: Запрос roots/list теперь имеет таймаут 10 секунд, предотвращая зависание всех инструментов.
  • Fixed: Освобождение блокировки перед ожиданием ответа устранило блокировку записей другими потоками.
v3.10.1patch
🕐 2 мес назад · релиз на GitHub ↗

Исправления Windows/Linux, улучшена фильтрация DLP, обновлен логин Codex и стабильность сессий.

  • Fixed: Исправлена ошибка загрузки Windows-бинарников с байтом 0x1A и улучшена очистка временных файлов.
  • Fixed: Linux musl-сборки теперь используют системный аллокатор вместо jemalloc для избежания конфликтов атомиков.
  • Fixed: Улучшена работа с путями и окружением на Windows, включая корректную обработку SystemDrive и HOME.
  • Fixed: Codex browser login теперь корректно отделяется от API-key маршрута, предотвращая ошибки 401.
  • Fixed: Фильтр DLP перестал ошибочно принимать номера задач и порты за телефонные номера.
v3.10.0minor
🕐 2 мес назад · релиз на GitHub ↗

v3.10.0: аудит MCP-серверов, дедупликация правил, телеметрия поведения и исправление ошибок в CLI.

  • Added: Аудит сторонних MCP-серверов: tools health выявляет неиспользуемые серверы и дублирующиеся правила, экономя контекст.
  • Added: Телеметрия поведения: отчеты о паттернах использования и встроенные подсказки для оптимизации расхода токенов.
  • Added: Прозрачность сжатия: измерение сокращения вывода в gain с доверительными интервалами.
  • Added: Пакеты P6: переносимые чекпоинты с валидацией целостности и безопасностью путей.
  • Fixed: Исправлен вывод футера pi-lean-ctx: теперь отображаются реальные данные, а не фиктивные нули.
  • Fixed: Улучшена стабильность CI: усилены проверки задержек и тесты для Windows.
v3.9.20majorbreaking
🕐 2 мес назад · релиз на GitHub ↗

Исправлены критические уязвимости: утечка секретов, потеря данных и ложная экономия; добавлен контроль вербатим-доставки.

  • Fixed: Фильтрация вывода теперь отключена по умолчанию; устранена потеря данных и ложное сжатие кода.
  • Fixed: Исправлена критическая уязвимость: байтовые чтения (head -c) больше не расширяются, предотвращая утечку секретов.
  • Fixed: Восстановлена работа эфемерного файрвола и архивации, ранее отключенные из-за бага в minimal_overhead.
  • Added: Добавлен лимит archive.verbatim_max_tokens для защиты контекстного окна от перегрузки большими выгрузками.
  • Fixed: Исправлена классификация команд zsh и корректная работа хуков deny для всех поддерживаемых агентов.
v3.9.19minor
🕐 2 мес назад · релиз на GitHub ↗

Релиз v3.9.19: добавлен слой OSS Intelligence, 84-й инструмент MCP, CLI для чекпоинтов и улучшена стабильность.

  • Added: Добавлен OSS Intelligence Layer с отслеживанием происхождения, синхронизацией памяти и мониторингом здоровья.
  • Added: Внедрена Solution Intelligence для трекинга решений, учета LOC и интеграции с CLI.
  • Added: Появился 84-й инструмент MCP ctx_memory для операций с кросс-агентной памятью.
  • Added: Добавлены новые CLI-команды: lean-ctx checkpoints, health --watch и import сессий.
  • Fixed: Исправлен pre-init handshake MCP, изоляция кэша CLI, защита от коррупции сжатия и права Bash.
v3.9.18major
🕐 2 мес назад · релиз на GitHub ↗

По умолчанию включен Full cognitive mode с FSRS и оптимизацией токенов, исправлены баги zsh, MCP и безопасности shadow mode.

  • Added: CognitiveMode::Full стал режимом по умолчанию для новых установок с полным набором инструментов оптимизации.
  • Added: Добавлен 83-й инструмент ctx_cognitive для управления состоянием когнитивного режима и новые CLI-команды для энтерпрайз-настройки.
  • Fixed: Исправлена ошибка zsh, приводившая к сбросу команд с глобами, и улучшена работа патчей в режиме batch.
  • Fixed: Устранено обход правил безопасности в shadow mode и исправлено падение MCP-сервера на неизвестных JSON-RPC методах.
  • Fixed: Закрыт пробел оптимизации для файлов от 500 до 2000 токенов и исправлено экранирование в PowerShell.
v3.9.17patch
🕐 3 мес назад · релиз на GitHub ↗

Исправлен критический паник при вложенных чтениях и оптимизированы блокировки сессий в инструментах.

  • Fixed: Устранён критический паник "Cannot start a runtime from within a runtime" при кросс-файловых импортах и префетчинге.
  • Fixed: Заменены Handle::block_on() в контекстах spawn_blocking на безопасные спин-лупы bounded_lock для всех модулей.
  • Fixed: В multi_path.rs сессии чтения заменён block_in_place на try_read_owned спин-луп для повышения стабильности.