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（前頭前皮質）とともに、自律コーディングエージェントのための全脳スイートを形成します。