cortexkit/magic-context

Magic Context – コーディングエージェントのための自己管理型長期メモリ

概要 – CortexKitスイートのプラグインで、AI搭載コーディングエージェントに「海馬」を与えます。プロジェクトのチャット履歴から有用な知識を自動的に抽出し、バックグラウンドで整理・統合し、セッションやツール（OpenCode、Pi、Oh‑My‑Pi）をまたいで検索可能にします。目標は、エージェントがタスク中に学習内容を忘れてしまうような、従来の圧縮による中断をなくすことです。

主な機能

• キャプチャ – エージェントの作業中に、ヒストリアンが会話をスキャンし、永続的な事実（設計判断、制約、設定値、命名規則）を抽出してプロジェクトメモリとして保存します。
• コンソリデート – オプションのドリーマーが（通常は夜間に）実行され、メモリを現在のコードベースと照合して検証し、重複を統合し、古いエントリを整理し、ドキュメントを最新の状態に保ちます。
• リコール – 毎ターン、システムが最も関連性の高いメモリをプロンプトに注入します。開発者はctx_search、ctx_expand、ctx_noteなどを呼び出して、メモリの取得・編集、gitコミットの検索、メモの延期ができます。
• コンテキストウィンドウ管理 – ヒストリアンが階層化されたコンパートメントを作成し、古いメッセージを重要度スコアとともに要約することで、アクティブなプロンプトを小さく保ちながら完全なスレッドを保持します。キャッシュを考慮した削減により、モデルのプロンプトキャッシュが無効化されないようにします。
• クロスハーネス対応 – 主要な3つのCortexKitハーネス（OpenCode、Pi、Oh‑My‑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
# または任意のOSでnpxを使用
npx @cortexkit/magic-context@latest setup

ウィザードが使用中のハーネスを検出し、適切なプラグイン（@cortexkit/opencode-magic-context、@cortexkit/pi-magic-contextなど）を追加し、ホストの組み込み圧縮を無効化し、ヒストリアン、ドリーマー、サイドキック用のモデルを選択するのを支援します。

設定 – JSONCファイル（magic-context.jsonc）で、ヒストリアン（必須）およびオプションでドリーマーとサイドキック用のモデルIDをハーネスごとに指定できます。また、埋め込み、時間認識、自動検索ヒントの有効/無効も設定できます。

典型的なワークフロー

1. セットアップウィザードを実行する（またはプラグインをハーネス設定に手動で追加する）。
2. ヒストリアンがチャット履歴の要約を開始し、永続的な事実をプロジェクトメモリに昇格させます。
3. オプションでドリーマー（/ctx-dream）を有効にして、夜間メンテナンスを実行します。
4. セッション中、エージェントは関連メモリを自動的に受け取ります。ctx_searchでクエリしたり、ctx_memoryで編集したりすることもできます。

使用するコマンド

コマンド	説明
/ctx-status	現在のメモリ統計、保留中のドロップ、ヒストリアンの進捗などを表示します。
/ctx-flush	キュー内のすべての削減/圧縮を即座に強制実行します。
/ctx-recomp	生の履歴からコンパートメントを再構築します（状態が破損している場合に便利）。
/ctx-dream	ドリーマーのメンテナンスサイクルをオンデマンドでトリガーします。
/ctx-search（ツール）	メモリ、チャット、gitコミット、メモを横断してセマンティック/キーワード検索します。
/ctx-note	ドリーマーが後で表面化できる延期メモを作成します。

重要性 – Magic Contextがない場合、各コーディングエージェントセッションは白紙の状態から始まり、定期的な「圧縮」によるコンテキストの中断に悩まされます。Magic Contextを使用すると、単一のセッションを数週間から数ヶ月間継続でき、プロジェクト知識を保持しながらトークンコストを削減し、エージェントのプロンプトキャッシュを安定させます。

詳細情報 – 完全なドキュメントは https://docs.cortexkit.io/magic-context にあり、DiscordコミュニティはREADMEにリンクされています。