cortexkit/magic-context

Magic Context – 코딩 에이전트의 해마

정의 – Magic Context는 CortexKit 생태계 내에 존재하는 플러그인입니다. 대규모 언어 모델 코딩 에이전트에 자체 관리형 장기 기억을 제공하여, 에이전트가 대화의 일부를 잊도록 강제하는 일반적인 "압축 일시 중지" 없이 단일 세션이 몇 주 또는 몇 달 동안 실행될 수 있게 합니다.

작동 방식

• 캡처 – 에이전트가 작업하는 동안 백그라운드 히스토리언이 전체 채팅 로그를 읽고, 지속적인 지식(설계 결정, 제약 조건, 명명 규칙 등)을 추출하여 프로젝트 메모리 데이터베이스에 저장합니다.
• 통합 – 선택적 드리머가 유휴 시간(밤)에 실행되어 현재 코드베이스에 대해 이러한 메모리를 검증하고, 중복을 병합하고, 문서를 업데이트하고, 유용한 관찰을 사용자 프로필로 승격합니다.
• 회상 – 각 턴에서 에이전트는 가장 관련성 높은 메모리와 대화의 압축된 보기를 자동으로 받습니다. 또한 ctx_search, ctx_expand, ctx_memory, ctx_note와 같은 도구를 호출하여 필요 시 정보를 검색하거나 편집할 수 있습니다.

주요 기능

• 자체 관리 컨텍스트 – 외부 압축 플러그인 불필요; Magic Context는 경쟁하는 컨텍스트 관리 훅을 비활성화하고 캐시 안정적 축소를 수행합니다.
• 계층적 히스토리언 구획 – 오래된 메시지는 가중 요약으로 요약되어 라이브 프롬프트 창을 작게 유지하면서 스레드를 보존합니다.
• 크로스 하네스 지원 – OpenCode, Pi, Oh‑My‑Pi (OMP)에서 작동; 메모리는 이러한 환경 간에 공유됩니다.
• 구성 가능한 모델 – 히스토리언에는 저렴한 모델을, 드리머에는 선택적 모델을 선택할 수 있습니다; 임베딩은 기본적으로 로컬 MiniLM 모델을 사용합니다.
• CLI 마법사 – npx @cortexkit/magic-context@latest setup이 환경을 감지하고, 올바른 플러그인(@cortexkit/opencode-magic-context, @cortexkit/pi-magic-context 등)을 설치하고, 충돌하는 압축 설정을 비활성화합니다.
• 진단 – npx @cortexkit/magic-context@latest doctor가 충돌을 확인하고, 데이터베이스를 검증하며, 일반적인 문제를 자동 수정할 수 있습니다.

일반적인 워크플로우

1. 설정 마법사를 실행합니다(또는 플러그인을 opencode.jsonc에 수동으로 추가).
2. 히스토리언용 모델 ID를 제공합니다(예: provider/model-id).
3. 코딩을 시작합니다; 히스토리언이 조용히 메모리 저장소를 구축합니다.
4. 선택적으로 드리머를 활성화하여 야간 유지 관리를 실행합니다.
5. 세션 중에 /ctx‑search, /ctx‑note 등을 사용하여 메모리를 쿼리하거나 편집합니다.

중요성 – Magic Context가 없으면 각 코딩 에이전트 세션은 빈 상태로 시작하고 컨텍스트를 압축하기 위해 주기적으로 일시 중지하여 연속성을 잃습니다. Magic Context는 일회용 에이전트를 결정, 코드 규칙, 과거 논의를 기억하는 장기 팀원으로 전환하여 반복적인 프롬프트를 줄이고 생산성을 향상시킵니다.

---

빠른 시작 요약

# 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
# 또는 모든 OS에서 npx 사용
npx @cortexkit/magic-context@latest setup

플러그인을 하네스 구성에 추가하고, 히스토리언 모델이 포함된 magic-context.jsonc를 생성하면 준비 완료입니다.

---

CortexKit의 일부 – Magic Context는 "해마" 부분입니다. AFT(감각운동 피질) 및 곧 출시될 Alfonso(전전두피질)와 함께 자율 코딩 에이전트를 위한 전뇌 스위트를 형성합니다.