Passoff

AIコーディングエージェント間でバトンを渡す — 文脈を失わずに。

メモリツールはすべてを保存します。Passoffは重要な瞬間を記録します。 Claude Code、Cursor、Codex、Windsurf、およびあらゆるMCPクライアント間でコンテキストを引き継ぐためのコマンドを1つ提供します。どのAIが何を誰に送ったかという完全なプロバナンス（来歴）を記録します。

なぜPassoffなのか

• ローカルファースト。 ~/.passoff/db.sqlite にSQLiteを使用。クラウドなし、アカウントなし、APIキーなし、テレメトリなし。

• プロバナンスを内蔵。 すべての引き継ぎで from_client、from_model、to_client、タイムスタンプを記録。MCPプロトコルがクライアント名を刻印するため、AIはどのツールが書き込んだかについて嘘をつくことができません。

• リネージ（系譜）を内蔵。 引き継ぎは親を参照し、複数のAIやセッションにわたる追跡可能なチェーンを形成します。

• 単一の目的。 引き継ぎのみ。メモリでも、オーケストレーションでも、ダッシュボードでもありません。

Related MCP server: meridian

30秒デモ

Claude Codeで機能を完成させる際：

あなた: /passoff — UI作業のためにCursorに切り替え

Claudeが構造化されたマークダウンの引き継ぎを作成し、{ id: "ph_aB3x9K" } を返します。

Cursorを開き、新しいチャットを開始：

あなた: /passoff-load

Cursorが passoff_load({ latest: true }) を呼び出し、マークダウンを取得して思考の途中から再開します。

後でチェーンを追跡：

$ passoff thread ph_GuqtDKDO
o ph_Mo12sReh  Refactor auth middleware
|  claude-code -> cursor  [loaded]
|
* ph_GuqtDKDO  Wired auth into login
|  cursor -> codex  [loaded]
|
o ph_T0s2ZQvD  Fixed login tests
   codex  [open]

インストール

npm i -g passoff

Node 20以上が必要です。

またはソースから実行：

git clone https://github.com/TheMrGU/passoff && cd passoff
npm install && npm run build
node dist/index.js --help

ワンショットセットアップ

リポジトリがローカルにチェックアウトされている場合、以下のコマンドでサポートされているすべてのクライアントにPassoffを一度に組み込めます：

npm run setup

これは npm install + npm run build を実行し、MCPサーバーをClaude Codeに登録（インストールされている場合 claude mcp add 経由）、~/.cursor/mcp.json、~/.codeium/windsurf/mcp_config.json、~/.codex/config.toml を書き込み/マージし、スラッシュコマンドテンプレートをインストールします。その後、各AIクライアントを再起動してください。

MCPクライアントへの手動組み込み

Claude Code

claude mcp add passoff -- npx -y passoff serve

Cursor — ~/.cursor/mcp.json (またはプロジェクト内の .cursor/mcp.json)

{
  "mcpServers": {
    "passoff": { "command": "npx", "args": ["-y", "passoff", "serve"] }
  }
}

Codex — ~/.codex/config.toml

[mcp_servers.passoff]
command = "npx"
args = ["-y", "passoff", "serve"]

Codexネイティブのスラッシュコマンドをインストール：

passoff install --client codex

これにより、/passoff:create、/passoff:load、/passoff:list、/passoff:search がローカルのCodexプラグインとして登録されます。

Windsurf、その他

同じstdioコマンドペアを使用します — docs/clients.md を参照してください。

スラッシュコマンド

passoff install 後、サポートされているすべてのクライアントで同じ4つのコマンドが利用可能になります（Codexは /passoff:create などを使用し、Claude CodeとCursorは /passoff、/passoff-load、/passoff-list、/passoff-search を使用します）。

MCPツール

オペレーターCLI

passoff serve                   # run MCP server (stdio) — invoked by clients
passoff list [--project X]      # recent handoffs table
passoff show <id>               # full markdown + metadata
passoff thread <id>             # lineage tree
passoff archive <id>            # mark archived
passoff delete <id>             # hard delete (confirms)
passoff clear [--project X]     # archive all open in a project (confirms)
passoff doctor                  # DB path, version, row counts, MCP config hints
passoff install                 # install Claude/Cursor/Codex command templates
passoff uninstall               # remove installed command templates

ストレージとスコープ

• DBの場所: ~/.passoff/db.sqlite (PASSOFF_DB_PATH で上書き可能)。

• プロジェクトのスコープ: PASSOFF_PROJECT_ROOT から派生。それ以外は最も近い .git ディレクトリ、それもなければ cwd。スラッグは <dir>-<6char hash> なので、2つの api/ ディレクトリが衝突することはありません。

• テレメトリなし。 ネットワーク呼び出しなし。SQLiteブラウザでDBを開くことができます。

Passoff vs 共有メモリツール

どちらも役割があります。解決する問題が異なります。

メモリツールは 「何が関連している可能性があるか？」 に答えます。Passoffは 「次に読み込むべきものはこれだ」 に答えます。

詳細な位置付け: docs/design.md。

FAQ

データはどこに保存されますか？ ~/.passoff/db.sqlite という単一のSQLiteファイルです。任意のSQLiteブラウザで開くことができます。クラウドコンポーネントはありません。

Passoffはネットワーク経由で何かを送信しますか？ いいえ。MCPサーバーはstdioのみです。CLIは外部に通信しません。セットアップスクリプトはローカルの設定ファイルのみを書き込みます。

2つのプロジェクトで同じDBを共有できますか？ はい。すべての引き継ぎはプロジェクトのスラッグにスコープされます。DBはグローバルですが、ビューはデフォルトでプロジェクトごとになります。

2つのAIが同じ引き継ぎで衝突することはありますか？ いいえ。読み込みによってステータスが open → loaded に切り替わり to_client が刻印されますが、アーカイブするまでセッションをまたいで再読み込み可能です。

[他のMCPクライアント]で使用できますか？ クライアントがstdio経由でMCPを話すなら、はい。同じように組み込んでください。docs/clients.md を参照してください。

なぜ会話を貼り付けるだけではいけないのですか？ 3つの理由があります。(1) 受信側のAIがノイズではなく、あなたが渡すことを選択した「正確なもの」を受け取れること。(2) 行が監査可能であること（from_client、from_model、タイムスタンプ）。(3) 複数ステップのワークフローにわたってリネージがスレッド化されること。

ステータス

アルファ版。 APIとストレージの形状は1.0までに変更される可能性があります。DBは加算的に自己移行しますが、時折変更が発生することを想定してください。IssueやPRの提出を歓迎します — 以下を参照してください。

貢献

CONTRIBUTING.md を参照してください。要約: npm install && npm test を実行し、PRを集中させ、メモリレイヤーやオーケストレーターをPassoffにバンドルしないでください。

ライセンス

MIT — LICENSE を参照してください。