yvgude/lean-ctx

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

Агенты⭐ 3 820Rustпоследний релиз: v3.10.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.10.2patch

🕐 4 дн назад · релиз на GitHub ↗

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

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

v3.10.1patch

🕐 15 дн назад · релиз на 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

🕐 23 дн назад · релиз на 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

🕐 26 дн назад · релиз на GitHub ↗

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

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

v3.9.19minor

🕐 1 мес назад · релиз на 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

🕐 1 мес назад · релиз на 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

🕐 1 мес назад · релиз на 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 спин-луп для повышения стабильности.