OpenHandoff

AIコーディングエージェント間の、ポータブルでローカルファーストなコンテキスト引き継ぎ。

OpenHandoff は、プロジェクトの永続的な真実を2つの小さなファイルに保持します:

• 人と Obsidian のための CONTEXT.md;

• エージェント、MCP アダプター、自動化のための context.json。

最初の MVP は意図的にシンプルで検査可能です: クラウドアカウントも隠れたデータベースもなく、秘匿化はハンドオフが書き込まれる前に行われます。将来のアダプターは、ベンダー固有のメモリ形式を強制することなく、Codex、Claude Code、Cursor、Windsurf のトランスクリプトを読み取ることができます。

OpenHandoff は公開リポジトリとチームのハンドオフ向けに設計されています: ファイルはプレーンテキストで、MCP サーバーは依存関係がなく、シークレットの形をした値は永続化前に秘匿化されます。

スキルパック

リポジトリには skills/ の下に3つのポータブルスキルが含まれています:

• openhandoff-context — エージェント間のコンテキストのキャプチャ、復元、パッキング。

• openhandoff-privacy — 共有前にハンドオフとトランスクリプトを監査。

• openhandoff-release — テスト済みで文書化された再現可能なリリースを準備。

スキルディレクトリを Codex スキルディレクトリにコピーするか、この GitHub リポジトリを使用して Codex スキルインストーラーでインストールします。スキルは意図的に狭い範囲に絞られているため、独立して使用できます。

Related MCP server: ai-cortex

クイックスタート

python -m venv .venv
source .venv/bin/activate
pip install -e .
openhandoff init .context --title "My project"
openhandoff capture .context \
  --title "My project" \
  --decision "Use SQLite" \
  --todo "Add the MCP adapter" \
  --notes "The next agent should run the test suite first."
openhandoff show .context

通常のユーザーインストールでは、リリース公開後に pipx install openhandoff を使用します。開発用の依存関係とチェックは CONTRIBUTING.md に文書化されています。

特定のタスク用にコンパクトなコンテキストスライスを構築します。一致する決定事項、TODO、ノート行が最初に保持され、その後、結果は要求された予算に合わせて決定的にトリミングされます:

openhandoff pack .context --task "MCP adapter" --max-chars 4000

MCP サーバー

依存関係のない MCP サーバーは、stdio 経由で load_handoff、save_checkpoint、search_handoff、pack_context を公開します:

openhandoff-mcp

ローカルエージェント設定では、ネットワークアクセスなしで openhandoff-mcp コマンドを使用します。サーバーはエージェントから提供されたハンドオフパスのみを読み書きします。

Codex 設定の例:

[mcp_servers.openhandoff]
command = "openhandoff-mcp"
args = []

Claude Desktop 設定の例:

{
  "mcpServers": {
    "openhandoff": {
      "command": "openhandoff-mcp",
      "args": []
    }
  }
}

エージェントイベントのキャプチャ

openhandoff-hook は stdin で JSON イベント(またはプレーンテキスト)を受け取り、資格情報の形をした値を秘匿化し、結果を .context/events.jsonl に追記します:

printf '%s\n' '{"type":"agent_message","message":"finished"}' \
  | openhandoff-hook --path .context

Codex は notify ペイロードをフックに直接送信できます。これを Codex 設定に追加します(コマンドは stdin で JSON ペイロードを受け取ります):

notify = ["openhandoff-hook", "--path", ".context"]

Claude Code の場合は、同じ実行可能ファイルを設定のコマンドフックに配線します。正確な設定ファイルは Claude Code のバージョンによって異なる場合があります。これは説明用の例です:

{
  "hooks": {
    "afterTurn": [
      {"command": "openhandoff-hook --path .context"}
    ]
  }
}

トランスクリプトのインポート

Codex と Claude Code の JSONL イベントストリームは、同じ形式にインポートできます:

openhandoff import-transcript ./rollout.jsonl .context --title "Project handoff"

ロードマップ

1. Cursor と Windsurf のトランスクリプトアダプター。

2. タスク固有のコンテキストパックにおけるファイルとコミットの引用。

3. シークレットスキャンとレビューゲートを備えた Obsidian と GitHub の同期。

プロジェクトの健全性

• ライセンス: MIT。LICENSE を参照。

• セキュリティ報告: SECURITY.md を参照。

• コントリビューション: CONTRIBUTING.md を参照。

• リリースノート: CHANGELOG.md を参照。

• アーキテクチャ: docs/architecture.md を参照。

• リリースプロセス: docs/releasing.md を参照。

このプロジェクトは初期段階であり、実際のフィードバック、統合、ドキュメントの改善を歓迎します。チャットのトランスクリプト、資格情報、プライベートな Obsidian データをコミットしないでください。