Ai Session Bridge

🚀 AI Session Bridge

AI Session Bridgeは、クロスツールのAI会話履歴リーダーです。同じワークスペース内の他のAIツールからの会話履歴に、任意のAIコーディングエージェントがアクセスできるようにします。

🚀 クイックスタート

AI Session Bridgeは、MCP（Model Context Protocol）サーバーとCLIで、AIコーディングアシスタントが複数のツールから会話履歴を読み取ることを可能にします。VS Code Copilot、Cursor、またはRovodevを切り替えるたびに最初から始めるのではなく、AIエージェントがこれまでの作業の完全なコンテキストにアクセスできるようになります。

┌─────────────────────────────────────────────────────────────────────┐
│                         Your Workspace                               │
│  /Users/you/dev/my-project                                          │
└─────────────────────────────────────────────────────────────────────┘
                                    │
            ┌───────────────┬───────┼───────┬───────────────┐
            ▼               ▼       ▼       ▼
    ┌───────────┐   ┌───────────┐  ┌───────────┐
    │ Copilot   │   │ Cursor    │  │ Rovodev   │
    │ Sessions  │   │ Sessions  │  │ Sessions  │
    └─────┬─────┘   └─────┬─────┘  └─────┬─────┘
          └───────────────┴───────┬───────┴───────
                                  ▼
                  ┌───────────────────────────┐
                  │   ai-session-bridge       │
                  │   MCP Server + CLI        │
                  │                           │
                  │  Tools:                   │
                  │  - list_sessions          │
                  │  - get_session            │
                  │  - search_sessions        │
                  │  - get_recent_context     │
                  └───────────────────────────┘

✨ 主な機能

• 📚 統一会話履歴読み取り：VS Code Copilot、Cursor、およびRovodevからの会話を読み取ります。
• 🔍 全文検索：SQLite FTS5を使用して、すべての会話を高速に検索します。
• 🚀 MCPサーバー：Model Context Protocolを介して会話履歴を公開します。
• 💻 CLIツール：コマンドラインから会話履歴を一覧表示、検索、およびエクスポートします。
• 🔒 セキュリティ：APIキー、シークレット、および機密データを自動的にフィルタリングします。
• ⚡ パフォーマンス：スマートキャッシュとインデックスを使用して、即座にアクセスできます。
• 🎯 ワークスペース対応：現在のワークスペースに自動的に会話をマッチングします。

📷 スクリーンショット

すべてのツールの会話履歴を一覧表示

AIの会話をきれいに整理されたテーブル形式で表示します。

ワークスペース対応の検索

現在のワークスペースを考慮した検索が可能で、必要な情報を正確に見つけることができます。

会話の詳細表示

適切なフォーマットで完全な会話履歴を表示します。

📦 インストール

本番環境での使用（推奨）

pipxを使用する（分離された、グローバルに利用可能）：

git clone https://github.com/frknyldz/ai-session-bridge
cd ai-session-bridge
pipx install .

これにより、ai-session-bridgeがシステムのPythonから分離された状態でグローバルにインストールされます。

PyPIから（公開された場合）：

pipx install ai-session-bridge

開発環境のセットアップ

クイックセットアップ（自動化）：

git clone https://github.com/frknyldz/ai-session-bridge
cd ai-session-bridge
./setup.sh

セットアップスクリプトは以下のことを行います：

• ✅ 仮想環境を作成します。
• ✅ すべての依存関係をインストールします（編集可能モード）。
• ✅ コミット前フックを設定します。
• ✅ 設定ディレクトリを作成します。
• ✅ インストールをテストします。
• ✅ venvとpipxの両方のインストールオプションを表示します。

手動セットアップ：

git clone https://github.com/frknyldz/ai-session-bridge
cd ai-session-bridge
python3 -m venv venv
source venv/bin/activate
pip install -e ".[dev]"

💻 使用例

CLIの使用方法

# 最近の会話履歴を一覧表示
ai-session-bridge list

# フィルターを指定して会話履歴を一覧表示
ai-session-bridge list --tool copilot --limit 5

# 完全な会話を表示
ai-session-bridge show <session-id> --tool copilot

# すべての会話履歴を検索
ai-session-bridge search "bug fix"

# キャッシュをクリア
ai-session-bridge cache clear

MCPサーバー

AIツールのMCP設定に追加します。

pipxでインストールした場合（推奨）

VS Code Copilot (settings.json)：

{
  "servers": {
    "ai-session-bridge": {
      "command": "/Users/YOUR_USERNAME/.local/bin/ai-session-bridge",
      "args": ["serve"]
    }
  }
}

Cursor/Rovodev (~/.config/mcp/mcp.json)：

{
  "mcpServers": {
    "ai-session-bridge": {
      "command": "/Users/YOUR_USERNAME/.local/bin/ai-session-bridge",
      "args": ["serve"]
    }
  }
}

venvを使用している場合（開発用）

venvのバイナリの完全パスを使用します。

{
  "mcpServers": {
    "ai-session-bridge": {
      "command": "/absolute/path/to/ai-session-bridge/venv/bin/ai-session-bridge",
      "args": ["serve"]
    }
  }
}

💡 使用アドバイス：./setup.shを実行すると、使用する正確なパスが表示されます！

PyPIリリース後

uvxを使用して自動的にダウンロードして実行します。

{
  "mcpServers": {
    "ai-session-bridge": {
      "command": "uvx",
      "args": ["ai-session-bridge", "serve"]
    }
  }
}

📚 ドキュメント

MCPツール

設定後、AIアシスタントは以下のツールにアクセスできます。

list_sessions

現在のワークスペースのすべてのAI会話を一覧表示します。

{
  "workspace_path": "/path/to/workspace",
  "tool_filter": ["copilot", "rovodev"],
  "limit": 10
}

get_session

特定の会話の完全な内容を取得します。

{
  "session_id": "abc123",
  "tool": "copilot",
  "workspace_path": "/path/to/workspace"
}

search_sessions

すべての会話でキーワードを検索します。

{
  "query": "authentication bug",
  "workspace_path": "/path/to/workspace",
  "limit": 20
}

get_recent_context

最近の会話から要約されたコンテキストを取得します（「中断したところから再開」に便利）。

{
  "workspace_path": "/path/to/workspace",
  "max_sessions": 3,
  "max_messages": 20
}

設定

~/.config/ai-session-bridge/config.yamlを作成します。

# スコープ: 含める会話
scope:
  mode: current_workspace  # current_workspace, all_workspaces, specified
  workspaces: []  # modeが"specified"の場合のみ使用

# 読み取るツール
tools:
  copilot: true
  cursor: true
  rovodev: true

# キャッシュ設定
cache:
  enabled: true
  max_age_days: 30

# 検索インデックス
search:
  enabled: true
  use_fts: true  # 高速検索にSQLite FTS5を使用

# セキュリティ: 機密内容をフィルタリング
filtering:
  enabled: true
  patterns:
    - "(?i)(api[_-]?key|apikey)[\"']?\\s*[:=]\\s*[\"']?[a-zA-Z0-9_-]{20,}"
    - "(?i)(secret|password|token)[\"']?\\s*[:=]\\s*[\"']?[^\\s\"']{8,}"
  replacement: "[REDACTED]"

# MCPサーバー設定
mcp:
  max_context_messages: 50
  max_context_sessions: 5

サポートされているツール

仕組み

会話の検出

1. VS Code Copilot：ワークスペースディレクトリをスキャンし、workspace.jsonファイルを読み取ってワークスペースパスをマッチングします。
2. Cursor：Composerの会話を含むグローバルSQLiteデータベース（state.vscdb）から読み取ります。
3. Rovodev：各会話ファイルのmetadata.jsonからワークスペースパスを読み取ります。

キャッシュとパフォーマンス

• 会話キャッシュ：変更されていないファイルの再解析を避けるためにメタデータを保存します。
• 検索インデックス：即座の全文検索にSQLite FTS5を使用します。
• 遅延読み込み：必要なときにのみ完全な会話内容を読み込みます。

セキュリティ

自動的に以下の内容をフィルタリングします。

• APIキーとトークン
• パスワードとシークレット
• 秘密鍵
• AWS資格情報
• GitHub/Slackトークン

具体的な使用例

例1: 前回の作業を続ける

ユーザー: "中断したところから再開して" AIはget_recent_contextを使用して、最後の数回の会話とそのメッセージを取得し、作業内容を理解します。

例2: 関連するディスカッションを見つける

ユーザー: "以前の会話で認証について話し合ったことはありますか？" AIはsearch_sessionsを使用して、クエリ「authentication」ですべてのツールで関連するメッセージを検索します。

例3: 過去の解決策を確認する

ユーザー: "データベース接続の問題を解決した会話を見せて" AIはsearch_sessionsを使用して会話を見つけ、get_sessionを使用して完全な会話を取得します。

開発

# リポジトリをクローン
git clone https://github.com/frknyldz/ai-session-bridge
cd ai-session-bridge

# 開発用依存関係をインストール
pip install -e ".[dev]"

# コミット前フックをインストール
pre-commit install

# テストを実行
pytest

# リントを実行
ruff check .

# リントの問題を自動修正
ruff check --fix .

# コードをフォーマット
ruff format .

詳細な開発ガイドラインについては、CONTRIBUTING.mdを参照してください。

ロードマップ

• [ ] 会話のタグ付けとカテゴリ分け
• [ ] LLMを使用した自動要約
• [ ] 会話を閲覧するためのWeb UI
• [ ] マシン間での会話同期
• [ ] より多くのAIツールのサポート（Continue、Windsurfなど）
• [ ] さまざまな形式（PDF、HTML）へのエクスポート

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

作者

Furkan Yıldız

謝辞

• AIツール間のコンテキストの連続性向上の必要性に触発されて開発されました。
• Model Context Protocolをベースに構築されています。