ctxfile

ctxfile

1つのコンテキストを、すべてのエージェントで、すべてローカルに。

ウェブサイト · ドキュメント · クイックスタート · クライアント · .ctxfile の規約 · セキュリティ

---

複数の AI エージェントを使っているとします。ターミナルの Claude Code、エディターの Cursor、考えをまとめるためのチャットタブ。それぞれがまっさらな状態から始まるのは、作業状態（計画、主要なファイル、git の状態、1時間前に決めたこと）が、頭の中やスクロールバックにしか残っていないからです。

ctxfile はローカルファーストの MCP サーバーです。プロジェクトの作業状態を1つの構造化されたコンテキストオブジェクトにスナップショットとして保存し、1回の呼び出しであらゆる MCP エージェントに渡します。あるエージェントでセッションを保存し、別のエージェントで続行できます。データがマシンの外に出ることはありません。

you → ctxfile → the same context, in every agent

30秒で始める

マシン上のすべてのクライアントを一度にセットアップ

npm install -g ctxfile
ctxfile connect          # lists the MCP clients it found
ctxfile connect --all    # adds ctxfile to each (backups kept, other servers untouched)

または、任意のコーディングエージェントに次のように伝えてください。「https://ctxfile.dev/setup.md に従って ctxfile をセットアップして」。

Claude Code（プラグインとして、またはコマンド1つで）

/plugin install ctxfile --marketplace ctxfile/ctxfile
claude mcp add --scope user ctxfile -- npx -y ctxfile

Cursor（プロジェクト内の .cursor/mcp.json、または全体設定の ~/.cursor/mcp.json）

{
  "mcpServers": {
    "ctxfile": { "command": "npx", "args": ["-y", "ctxfile", "--root", "${workspaceFolder}"] }
  }
}

Codex CLI

codex mcp add ctxfile -- npx -y ctxfile --root .

Claude Desktop（ターミナル不要）：ctxfile-macos-arm64.mcpb をダウンロードし、設定 → 拡張機能にドラッグしてください。このバンドルにはコンパイル済みのネイティブモジュールが含まれているため、現時点では macOS（Apple Silicon）のみ対応しています。Windows または Intel Mac では、代わりに上記の stdio JSON を claude_desktop_config.json に追加してください。

その他すべてのクライアント：ctxfile は標準的な stdio サーバーなので、コマンドは npx -y ctxfile だけです。VS Code、Windsurf、Zed、Cline、Gemini CLI、OpenCode、Warp、Goose、LM Studio、Kiro、JetBrains、Visual Studio、Amp、OpenClaw、Hermes などのワンクリックインストールリンクとコピー＆ペースト用の設定手順は、ctxfile.dev/docs/clients のクライアント別タブにあります。

次に、エージェントに 「コンテキストを読み込んで」 と伝えるか、get_context を呼び出してください。Node ≥ 20 が必要です（Windows では ≥ 22）。

自動化する

「これを保存して」と入力する必要はありません。1つのコマンドでスキルをインストールすると、通常の作業中にコンテキストをいつチェックポイントとして保存するか、保存のたびに通知すること（通知なしでの保存は行わず、いつでも一時停止でき、常に確認可能）を、あらゆるエージェントに教えられます。

ctxfile init

1つの正規仕様から、それぞれのハーネスが読み込める形式に生成します。Claude Code、OpenCode、OpenClaw、Hermes 用のエージェント向け SKILL.md（4つすべてのスキルシステムで使えるポータブルなファイル）、Cursor のルール、管理対象の GEMINI.md / AGENTS.md ブロックを生成します。詳細は ctxfile.dev/docs/automatic をご覧ください。

チャットタブでもコンテキストを引き継げます

CLI やエディターのエージェントが MCP 経由で読み込むのと同じコンテキストを、ウェブチャットボットにも渡せます。Grok、ChatGPT、Claude web、Perplexity をカスタム MCP コネクターとして暗号化された Sync vault に接続するか、ctxfile export を実行して、エンベロープを任意のプロンプト入力欄（Gemini など）に貼り付けてください。手順はこちら：ctxfile.dev/docs/webchat。

デフォルトでプライベート

最も重視している部分なので、まずはこちらから説明します。

• デフォルトの経路では、ネットワーク呼び出しは一切ありません。ファイルと git のみを使用します。
• 秘密情報らしき内容（クラウドキー、トークン、秘密鍵、JWT、password= の代入）は、スナップショットに取り込まれる前にマスキングされます。.env*、キー ファイル、認証情報ファイルは一切読み込まれません。
• コア機能はプロジェクトに対して読み取り専用です。リポジトリ、git の状態、その他のものに書き込むことはありません。
• テレメトリーはデフォルトで無効です。 匿名の週次インストール通知がありますが、オプトインした場合にのみ有効になります。
• ネットワークコネクター（Notion、ローカル Ollama による要約、Sync）は、明示的に設定した場合にのみ有効になります。

Pro と Sync で追加される機能と、それらが決して参照できない情報を含む完全なモデルについては、ctxfile.dev/security に記載しています。

機能

スナップショット	get_context は、構造化された単一の ContextObject を返します。プラン文書、トークン予算に収まるよう選定された重要ファイル、git の状態、オプションの Notion ページとローカル LLM による要約が含まれます。
保存と再開	save_session は、現在の会話をエージェントが要約した内容を保存します。continue_thread は、出典情報付きで統合された履歴を次のエージェントに渡します。異なるハーネス、異なるプロバイダー、コールドスタートでも、前回の続きから作業を再開できます。
スレッド	エージェントやマシンをまたいで作業（「第3四半期のキャンペーン」など）を追跡する、永続的な ID です。handoff: true を指定すると、状態、根拠付きの決定事項、順序付けされた未完了項目、注意点を含む完全な引き継ぎパッケージが必須になります。
メモリのインポート	ingest_memory は、ChatGPT、Grok、Claude などのアシスタントがあなたについて把握している情報を ctxfile に取り込みます。1つのプロンプト（ctxfile memory prompt）、厳密なスキーマ、グローバルまたはプロジェクト単位のスコープを使用します。指示とプロフィール情報は承認待ちとなり、重複は統合され、却下した内容は再び候補に表示されません。以降、すべてのエージェントが get_context でその情報を取得できます。ドキュメント。
タスク	post_task、list_tasks、update_task：あるエージェントが、別のエージェントのためにスレッド上に作業を残します（「ChatGPT に見込み顧客向けメールの下書きを作成してもらう」など）。担当エージェントは受信箱でタスクを確認し、開始前にあなたに確認します。エージェントが登録したタスクは、ダッシュボードまたは CLI で承認するまで提案のままです。承認にはデバイス上の署名が使われ、送信、公開、コードのプッシュ、支出を伴う操作には、それぞれ個別の承認が必要です。ドキュメント。
汎用インジェスト	ingest_context は、ネイティブパーサーを持たないハーネス向けの、スキーマで検証された入口です。プロンプトがアダプターとなるため、まだ存在しないものも含め、MCP に対応するすべてのエージェントをサポートします。
クラウドエージェント	ctxfile export は、ホスト型コーディングエージェントや CI など、あなたのマシンに一切触れないエージェント向けに、リポジトリに安全な静的成果物を書き出します。この形式はオープンな仕様です：.ctxfile 規約。
ダッシュボード	ctxfile ui：127.0.0.1 上で動作するローカルの操作パネルです。スナップショットを実行し、コネクターを監視し、コンテキストを参照して、git の状態を確認できます。
Sync（オプション）	セルフホスト可能なリレーを介した、エンドツーエンド暗号化 vault です。Argon2id による鍵導出と、各 blob に対する XChaCha20-Poly1305 を使用します。リレーには暗号文のみが保存されます。

モノレポ

パッケージ	内容	ライセンス
packages/core	npm の ctxfile：MCP サーバー、スナップショットエンジン、スレッド、取り込み、エクスポート、Sync クライアント、ダッシュボードホスト	Apache-2.0
packages/relay	npm の @ctxfile/relay：セルフホスト可能な Sync リレーとチームハブ（暗号化されたボルト、/mcp エンドポイント、フェデレーション、監査ログ）。Docker イメージは 1 つです	Apache-2.0
packages/dashboard + packages/ui-kit	ctxfile ui で提供されるローカルのインストゥルメント UI	Apache-2.0
apps/web	ctxfile.dev：サイトとドキュメント	Apache-2.0

正直なオープンコア

このリポジトリのすべては Apache-2.0 で、単独でいつまでも利用できます。有料の Pro アドオン（別個のクローズドパッケージ）では、Claude Code、Cursor、Codex CLI、OpenCode、Gemini CLI、Aider、OpenClaw、Hermes Agent から最近のセッションを読み取るセッションコネクター、セッションをまたいだ暗号化メモリ、複数プロバイダーに対応した consult（Anthropic、1 つのキーで数百のモデルを利用できる OpenRouter、OpenAI 互換の任意のエンドポイント、またはローカルの Ollama）、AI が要約して作成するプロンプト Playbooks、ローカルでの音声キャプチャが追加されます。ライセンスは Ed25519 署名付きのキーで、オフラインで検証されます。電話ホームは一切ありません。Pro はオープンソースの開発を支えます。

貢献

皆さんからのイシュー、PR、そして一風変わったハーネスの報告をお待ちしています。CONTRIBUTING.md から始めてください。取り込む形式、MCP クライアント特有の挙動、見つけたマスキング漏れの一つひとつが、プロジェクト全体の改善につながります。

• バグと機能要望：イシュー
• 質問と成果の共有：ディスカッション
• セキュリティ報告：SECURITY.md（脆弱性については、公開イシューを作成しないでください）

git clone https://github.com/ctxfile/ctxfile.git && cd ctxfile
npm install
npm run build && npm test    # the whole gate: lint, typecheck, tests

スターの推移

ctxfile がコールドスタートを減らしてくれたなら、スターを付けることで、ほかの人にも見つけてもらいやすくなります。

ライセンス

Apache-2.0。「ctxfile」と ctxfile のロゴは ctxfile の商標です。ライセンスの対象はコードであり、名称ではありません。