Где взять

cortexkit/magic-context — открыть на GitHub

Открытая лицензия: MIT · 1694 stars.

Magic Context — это инструмент для управления памятью кодинг-агентов, который заменяет стандартные паузы на «уплотнение» контекста непрерывным фоновым процессом. Если вы устали от того, что ваш ИИ-помощник забывает детали проекта после перезапуска сессии или «зависает» при очистке памяти, этот инструмент поможет сделать работу над кодом непрерывной.

Зачем это нужно

Обычно работа с кодинг-агентом напоминает найм временного сотрудника: вы даете задачу, он её выполняет, а затем «увольняется», теряя весь накопленный опыт. В процессе работы агент часто сталкивается с «компакцией» (compaction) — принудительной очисткой контекстного окна, которая прерывает поток мыслей и приводит к потере важных данных. Magic Context выступает в роли «гиппокампа» для агента: он формирует, консолидирует и извлекает воспоминания о проекте в фоновом режиме, позволяя одной сессии длиться неделями или месяцами.

Как это работает

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

  1. Захват (Capture): В процессе работы «историк» сжимает историю диалогов, выделяя долгосрочные знания — принятые решения, ограничения и архитектурные соглашения. Это превращает обычную работу в базу знаний проекта.
  2. Консолидация (Consolidate): В ночное время или в периоды простоя «агенты-сновидцы» проверяют накопленные воспоминания, удаляют дубликаты и устаревшие записи, оставляя только актуальную информацию.
  3. Воспоминание (Recall): Нужные данные автоматически всплывают в нужный момент. Агент может искать по прошлым разговорам, истории Git и накопленным знаниям, причем эта память общая для разных инструментов, таких как OpenCode и Pi.

Важно, что все эти процессы происходят в фоновом режиме, не прерывая работу агента и не вызывая пауз, характерных для стандартных систем управления контекстом.

Как начать работу

Для установки предусмотрен интерактивный мастер настройки, который автоматически определяет вашу среду, настраивает модели и устраняет конфликты с другими плагинами.

  • Для macOS/Linux: используйте скрипт curl -fsSL https://raw.githubusercontent.com/cortexkit/magic-context/master/scripts/install.sh | bash.
  • Для Windows (PowerShell): используйте irm https://raw.githubusercontent.com/cortexkit/magic-context/master/scripts/install.ps1 | iex.
  • Универсальный способ: команда npx @cortexkit/magic-context@latest setup.

После установки рекомендуется запустить npx @cortexkit/magic-context@latest doctor. Эта команда проверит систему на наличие конфликтов с другими плагинами (например, с DCP или встроенными функциями OpenCode) и при необходимости предложит автоматические исправления.

Границы применимости

Magic Context — это часть экосистемы CortexKit, и он требует настройки модели для «историка» (historian.model). Без указания конкретной модели в конфигурационном файле magic-context.jsonc плагин не сможет сжимать историю, и вы будете получать уведомления о необходимости внимания к управлению памятью.

Важно учитывать, что инструмент не восстанавливает историю сессий, которые были созданы до его установки — он начинает «запоминать» проект только с момента активации. Также Magic Context несовместим с другими плагинами, которые пытаются управлять контекстом одновременно, поэтому при установке он автоматически отключает конфликтующие функции, чтобы избежать «двойного сжатия» и перегрузки кэша.

Вердикт

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

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

Похожие материалы