Context Sync

🚀 Context Sync: 🧠 AI開発のためのメモリ層

Context Syncは、すべての開発ツール、セッション、プロジェクトにまたがってAIシステムに永続的なメモリを提供するオープンソースのインフラストラクチャです。これにより、AIが会話間でコンテキストを失う問題を解決し、開発者は効率的にAIを活用できます。

🚀 クイックスタート

インストール

# AI開発の未来
npm install -g @context-sync/server

初回セットアップ

インストール後、AIツールを再起動して、次のコマンドを入力します。

help me get started with context-sync

Context Syncは自動的に設定を行い、自然言語でセットアップをガイドします。

各プラットフォームのセットアップ

VS Code + GitHub Copilot

Cursor

setup cursor

{
  "mcpServers": {
    "context-sync": {
      "command": "npx",
      "args": ["-y", "@context-sync/server"]
    }
  }
}

Claude Desktop

# 設定ファイルを編集
notepad "%APPDATA%\Claude\claude_desktop_config.json"

# 設定ファイルを編集
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# 設定ファイルを編集
nano ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "context-sync": {
      "command": "npx",
      "args": ["-y", "@context-sync/server"]
    }
  }
}

Continue.dev (VS Code拡張)

mcpServers:
  context-sync:
    command: npx
    args: ["-y", "@context-sync/server"]

Windsurf IDE

Zed Editor

TabNine

{
  "context-sync": {
    "command": "npx",
    "args": ["-y", "@context-sync/server"]
  }
}

✨ 主な機能

永続的なAIメモリ

Context Syncは、すべての開発環境にまたがってAIシステムに永続的でクエリ可能なメモリを作成します。これにより、AIツールは同じ共有メモリを持つことができ、会話間でコンテキストを失うことがなくなります。

Notionとの統合

v1.0.3から、AIコンテキストを直接Notionに同期できるようになりました。インタラクティブなセットアップウィザードを使用して、簡単に設定できます。

# Context Syncをインストール
npm install -g @context-sync/server

# セットアップウィザードを実行
context-sync-setup

# ウィザードの手順:
# 1. ブラウザでNotionの統合ページを開きます。
# 2. ステップバイステップでガイドされます (2つの値をコピー&ペーストするだけ)。
# 3. 接続を自動的にテストします。
# 4. すべてを保存します。

機能としては、Notionワークスペースの検索、ページの読み取りと更新、新しいドキュメントの自動作成、決定のエクスポート、プロジェクトダッシュボードの生成などがあります。

複数プロジェクトのサポート

Context Syncは複数のプロジェクトを美しく扱うことができます。各プロジェクトは独自のアーキテクチャ決定、技術スタック、TODO、コードコンテキスト、会話履歴を維持します。

You: "Switch to my blog project"
AI: [loads blog context instantly]

You: "List my projects"
AI: 
  1. TaskFlow (Next.js + Supabase)
  2. Personal Blog (Astro)
  3. Client Website (WordPress)

You: "Switch to TaskFlow"
AI: [back to TaskFlow context]

📦 インストール

グローバルインストール

npm install -g @context-sync/server

Notion統合のインストール

# Context Syncをインストール
npm install -g @context-sync/server

# セットアップウィザードを実行
context-sync-setup

💻 使用例

フリーランス開発者のワークフロー

月曜日の朝 (Cursor)

You: "Initialize project 'EcommerceClient' - Next.js 14, Stripe, PostgreSQL"
AI: "Project created! ✓"
*Build product catalog for 3 hours*

火曜日の午後 (Claude Desktop)

You: "Continue EcommerceClient - add shopping cart"
AI: "Adding cart to your Next.js app with Stripe integration.
     Using the product schema we defined yesterday..."

水曜日 (Cursor)

You: "Switch back to Cursor. Review cart implementation"
AI: "Analyzing cart code... found 2 potential improvements..."

このように、ツール間で再説明する必要がなく、コンテキストを失うことなく継続的な進捗が可能です。

📚 ドキュメント

詳細なドキュメントは、Context Sync v1.0.0 Comprehensive Documentation を参照してください。また、Notion統合の詳細ガイドは Full Notion Integration Guide → を参照してください。

🔧 技術詳細

分散型AIメモリの仕組み

Context Syncは、Model Context Protocol (MCP) を使用して、開発者とAIシステムの間に永続的な知識層を作成します。

Your Development Environment
┌─────────────────────────────────────────────────────────┐
│  IDE/Editor        AI Tool           Browser/Web        │
│  ┌───────────┐    ┌───────────┐     ┌─────────────┐    │
│  │  Cursor   │    │  Claude   │     │ Claude.ai   │    │
│  │  VS Code  │    │  Desktop  │     │  Web app    │    │
│  │  Vim/etc  │    │  Copilot  │     │  Other AIs  │    │
│  └─────┬─────┘    └─────┬─────┘     └──────┬──────┘    │
└────────┼──────────────────┼─────────────────┼───────────┘
         │                  │                 │
         └──────────────────┼─────────────────┘
                            │ MCP Protocol
                            │
┌───────────────────────────▼─────────────────────────────┐
│              Context Sync (Open Source)                 │
│                                                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐ │
│  │   Memory    │  │   Files     │  │    Git & Code   │ │
│  │  • Projects │  │  • Read     │  │  • Status       │ │
│  │  • Context  │  │  • Write    │  │  • Diffs        │ │
│  │  • History  │  │  • Search   │  │  • Analysis     │ │
│  └─────────────┘  └─────────────┘  └─────────────────┘ │
│                                                         │
│            Local SQLite Database (~/.context-sync/)    │
└─────────────────────────────────────────────────────────┘

このアーキテクチャにより、Universal compatibility（すべてのMCP対応AIと互換性がある）、Local ownership（すべてのデータが自分のマシンに残る）、Zero vendor lock-in（オープンソースで拡張可能）、Intelligent caching（AIが必要なときに必要なものだけをロードする）といった利点があります。

なぜオープンソースか

AIメモリは企業によって管理されるべきではありません。Context Syncは、AI会話間でコンテキストを失うこと、単一のAIプラットフォームにロックインされること、開発データをコントロールできないこと、基本的なメモリ機能にサブスクリプション料を支払うことに疲れた開発者によって構築されました。

• Local-first: データは自分のマシンに残ります。
• Platform agnostic: MCPをサポートする任意のAIと動作します。
• Community-driven: 開発者によって開発者のために構築されています。
• Extensible: 無制限のカスタマイズが可能なオープンアーキテクチャです。

📄 ライセンス

Context SyncはMITライセンスの下で提供されています。商用利用、自由な変更、公開的な再配布が可能です。これは本当の意味でのオープンソースであり、二重ライセンススキームや、「エンタープライズ」と「コミュニティ」バージョンの区別、機能の有料化やサブスクリプション制、独自の拡張機能やロックされたエコシステムはありません。

開発者コミュニティへの参加

貢献の理由

Context Syncは開発者コミュニティによって開発者コミュニティのために構築されています。貢献することで、AIツールの標準を形成し、自分自身の問題を解決し、最先端の技術を学び、AI開発ツールを本当にオープンで拡張可能にする運動に参加できます。

貢献の方法

コード貢献

• 新しいAIプラットフォーム（Gemini、Ollamaなど）のサポートを追加する。
• 新しい分析ツール（Pythonの依存関係追跡など）を実装する。
• より多くのエディタ（Vim、Emacsなど）の統合を構築する。
• パフォーマンスとメモリ使用量を最適化する。

非コード貢献

• ドキュメントやチュートリアルを書く。
• ベータ機能をテストし、バグを報告する。
• ユースケースやワークフローを共有する。
• ディスカッションで他の開発者を支援する。
• サンプルプロジェクトやテンプレートを作成する。

コミュニティビルディング

• 他の開発者にContext Syncを共有する。
• 自分の経験についてブログ記事を書く。
• カンファレンスやミートアップで話す。
• ロードマップの計画に貢献する。

現在の優先事項

• [ ] Pythonエコシステムのサポート - pip、poetry、要件分析
• [ ] モバイル/ウェブ統合 - React Native、Expo、ウェブ開発ワークフロー
• [ ] Docker/コンテナ化 - コンテナ化されたアプリのワークスペース検出
• [ ] より多くのGit統合 - PR分析、コミットメッセージ生成
• [ ] パフォーマンス最適化 - より速いワークスペーススキャン、より良いキャッシュ
• [ ] UI/ダッシュボード開発 - メモリ管理のためのウェブインターフェース

貢献の始め方

1. リポジトリをスターしてサポートを示します。
2. ディスカッションに参加してアイデアを共有し、助けを求めます。
3. CONTRIBUTING.mdを読むことで技術的なガイドラインを確認します。
4. good-first-issue または help-wanted とラベル付けされた問題を選択します。
5. PRを提出します - 迅速にレビューし、フィードバックを提供します。

初心者でも歓迎です！多くの貢献者がここから始めました。

コミュニティリンク

• GitHub Discussions: 機能リクエスト、質問、成果の展示
• Issues: バグレポートと機能計画
• Pull Requests: コード貢献歓迎
• ロードマップ: ROADMAP.md - 次に何が予定されているかを確認できます。

トラブルシューティング

Claude DesktopがContext Syncを認識しない場合

1. インストールを確認します。

context-sync --version

2. 設定ファイルを確認します。

# Mac/Linux
cat ~/.config/Claude/claude_desktop_config.json

# Windows
type %APPDATA%\Claude\claude_desktop_config.json

3. Claudeを完全に再起動します。

• Mac: ⌘ + Q (強制終了)
• Windows: タスクトレイのアイコンを右クリック → 終了

4. ClaudeのMCPサーバーを確認し、設定でContext Syncを探します。

解決しない場合は、Create an issue を作成してください。

CursorがContext Syncを認識しない場合

1. Cursorの設定を開き、Settings → MCP を選択します。
2. 以下の設定が存在することを確認します。

{
  "mcpServers": {
    "context-sync": {
      "command": "npx",
      "args": ["-y", "@context-sync/server"]
    }
  }
}

3. CursorのMCPサーバーをリフレッシュします。
4. テスト: AIに "What's my current project?" と問いかけます。

"No active project" エラーの場合

まず、ワークスペースを設定します。

You: "Set workspace to /path/to/your/project"

または、既存のプロジェクトを確認します。

You: "What projects do I have?"
You: "Switch to [project-name]"

プラットフォーム間でコンテキストが同期されない場合

1. プラットフォームのステータスを確認します。

You: "Check platform status"

2. 両方のプラットフォームが設定されていることを確認します。
3. 手動で同期を試みます。

You: "Sync context to Cursor"

詳細なヘルプは TROUBLESHOOTING.md を参照してください。