context-sync

Context Sync

MCP を介して AI コーディングツールにプロジェクトのローカル優先メモリーを提供します。

Context Sync は、コードベースのための永続的なメモリーレイヤーをエージェントに提供します。

• プロジェクトの概要と技術スタック
• 作業状況、決定事項、制約、注意点
• 構造化されたファイル探索
• Git を考慮したコンテキスト
• オプションの読み取り専用 Notion 検索

機能

Context Sync は、セッションの継続性を保つために設計されています。以前の会話をモデルに記憶させるのではなく、重要なプロジェクトコンテキストを保存し、少数の MCP ツールを通じて取得できるようにします。

現在の主要なツールは次のとおりです。

• set_project
• remember
• recall
• read_file
• search
• structure
• git
• notion

インストール

グローバルにインストールします。

npm install -g @context-sync/server

グローバルインストール中に自動設定が実行されます。インストール後、AI ツールを再起動してください。

グローバルではなくローカルにインストールした場合、自動設定は実行されません。docs/CONFIG.md の手動設定ガイドを使用してください。

確認

MCP ツールの一覧に context-sync が表示されていることを確認します。

• Claude Desktop：ツール一覧を開きます
• Cursor：ツール一覧を開きます
• VS Code / Copilot Chat Agent mode：ツールを確認します
• Continue.dev：Continue パネルを開きます
• Codex CLI：codex mcp list
• Claude Code：claude mcp list

自動設定に失敗した場合は、docs/TROUBLESHOOTING.md と docs/CONFIG.md を参照してください。

オプションの Notion 設定

Notion 連携を利用する場合は、セットアップウィザードを実行します。

context-sync-setup

または：

npx context-sync-setup

Notion のサポートは、ツールのインターフェースでは意図的に読み取り専用になっています。

• notion({ action: "search", query: "..." })
• notion({ action: "read", pageId: "..." })

初回のワークフロー

新しいセッションを開始するたびに、まずプロジェクトを設定します。

1. set_project({ path: "/absolute/path/to/project" })
2. recall()
3. structure({ depth: 2 })
4. read_file({ path: "src/index.ts" })
5. remember({ type: "decision", content: "Use SQLite for local storage" })

推奨パターン：

• プロジェクト／セッションの開始時に set_project を 1 回実行します
• recall でコンテキストを復元します
• structure と search で探索します
• read_file で対象を絞って確認します
• 現在のセッション後も残すべき情報がある場合は remember を使用します

Git 連携

Git リポジトリ内で set_project を実行すると、Context Sync はコンテキストを自動的に取得するためのフックをインストールできます。

インストールされるフック：

• post-commit
• pre-push
• post-merge
• post-checkout

フックには Context Sync Auto-Hook のマークが付けられ、既存のフックは先にバックアップされます。

git ツールは次の機能をサポートします。

• status
• context
• hotspots
• coupling
• blame
• analysis

データと設定

デフォルトの保存場所：

• データベース：~/.context-sync/data.db
• 設定：~/.context-sync/config.json
• インストール状況：~/.context-sync/install-status.json

データベースのカスタム設定：

• CLI：context-sync --db-path /absolute/path/to/db
• 環境変数：CONTEXT_SYNC_DB_PATH

ストレージの詳細は docs/DATA.md を参照してください。

対応プラットフォーム

• Claude Desktop
• Cursor
• VS Code + GitHub Copilot
• Continue.dev
• Zed
• Windsurf
• Codeium
• TabNine
• Codex CLI
• Claude Code
• Antigravity

ドキュメント

• docs/TOOLS.md
• docs/CONFIG.md
• docs/TROUBLESHOOTING.md
• docs/DATA.md
• docs/RELEASE_NOTES.md