Pairdown

マルチプレイヤーMarkdown、エージェントが部屋にいます。

1つのサーバーがすべてのドキュメントを保持します。人々はリンクを開いて同じドキュメントを一緒にライブ編集し、余白にコメントを残します。部屋にいる誰でも自分のClaude Codeセッションを連れてくることができます。それは名前付きの参加者として表示され、誰かが言及するまで静かにして、呼び出されたスレッドで応答します。

ブラウザで動作し、何もインストールする必要はありません。ルーム、編集、コメント、共有はすべて、エージェントがどこにも接続されていなくても機能します。Claude Codeプラグインはセッションを接続するためのオプションであり、ドキュメント自体を保持することはありません。

サーバーを実行する

ホスティングにはチェックアウトとbunが必要です:

bun install
bun run build          # bundles the browser client into public/js
bun run src/server.ts  # http://127.0.0.1:8790

1つのプロセスがすべてのルームを提供します。/はルームインデックスです。サーバー上のすべてのルームがそれぞれの/r/<id>にリンクされ、作成フォームがあります。ルームはdata/rooms/の下に1ファイルずつ永続化され、プロセスを超えて存続します。

Related MCP server: agent-room-mcp

エージェントを連れてくる

このリポジトリからプラグインをインストールします。リポジトリ自体がマーケットプレイスなので、コマンドは1つではなく2つです:

claude plugin marketplace add rohanrichards/pairdown
claude plugin install pairdown@pairdown

インストールでは4つの項目が求められますが、最初の2つが重要です:

後で/plugin configure pairdownで変更できます。

node（22以降）がPATHに必要です。このリポジトリをクローンしたり依存関係をインストールする必要はありません。エージェントは単一のバンドルファイルとして提供され、そこから直接実行されます。

bunはルームサーバーをホストする場合にのみ必要です。サーバーはBun.serve上に構築されているためです。他の人のルームにエージェントを連れて行く場合は不要です。

プラグイン自体を開発するには、claude --plugin-dir .でチェックアウトからロードし、インストールせずに、/reload-pluginsで編集内容を反映できます。

プラグインはMCPサーバーを実行し、クライアントとしてルームサーバーに接続します。プラグインが有効な間PATHにあるpairdownバイナリは、ルームサーバーがまだ起動していない場合にオンデマンドで起動します。

接続後、セッションはroom_listを呼び出し、次にroom_createまたはroom_joinを呼び出し、その後read、outline、search、edit、append、insert、comments、reply、resolveを使用します。

エージェントは名前が呼ばれるまで休眠状態です。コメントがそのハンドルに言及しない限り、セッションには何も届きません。したがって、4人のエージェントがいるルームは、誰かがそのうちの1人を要求するまで、誰もいないルームと同じくらい静かです。

同じ4つの設定は環境変数でもあり、プラグインの外部でエージェントを実行するために使用できます:

環境変数は同じ名前のプラグイン設定よりも優先されます。これにより、設定を変更せずに別のハンドルで2番目のエージェントを実行できます:

PAIRDOWN_AGENT=scout PAIRDOWN_OWNER=Rohan claude

更新

インストールしても既存のインストールは新しいバージョンに移動しません。プラグインはすでにインストールされていると報告し、実行中のバージョンをそのままにします。新しいリリースを取得するには:

claude plugin marketplace update pairdown
claude plugin uninstall pairdown@pairdown
claude plugin install pairdown@pairdown

実際に実行されているものをclaude plugin listで確認してください。重要なのはキャッシュにあるものではなく、そこに表示されるバージョン番号です。

ハンドルに言及すると、そのセッションに即座に通知されます。タグのないコメントは、誰かが「send to claude」を押すまで待機します。即時通知にはさらにチャンネル研究プレビューが必要で、Team/Enterpriseでは組織管理者がchannelsEnabledを設定する必要があります。設定しないと通知は静かに破棄され、他のすべては機能します。

共有キーゲート

PAIRDOWN_SECRETを設定すると、サーバー全体が1つのキーの背後に置かれます。ブラウザはフォームを取得してからセッションクッキーを取得し、エージェントとスクリプトはAuthorization: Bearer <key>を送信します。未設定の場合、サーバーは以前と同様にオープンです。

PAIRDOWN_SECRET="$(openssl rand -base64 32 | tr -d /+= )" bun run src/server.ts

これは認証であり、認可ではありません。1つのキーは、それを保持する全員が同じ主体であることを意味します。誰も区別できず、個別に失効させることもできず、サーバー上のすべてのルームが同じドアの背後にあります。これは、監視付きデモがトンネルを通過できるようにするために存在し、URLを見つけた人にボックスを渡さないようにするためです。サーバーを公開したままにする方法ではありません。

この種のゲートが通常間違える部分を、これは適切に処理します。比較は定数時間で、クッキーはキー自体ではなくキーのHMACを保持し、WebSocketアップグレードもページと一緒にゲートされます。HTMLだけをゲートして/wsをゲートしないと、ドアをロックして窓を開けたままにすることになります。

テスト

bun test
bun run src/smoke.ts

smoke.tsは使い捨てのルームをシードし、それに対してMCPサーバーを起動し、ツールサーフェス全体をエンドツーエンドで駆動します。

まだ実装されていないもの

アカウント、SSO、ルームごとの権限、ホスティング。まずはローカル、デモ用のトンネル。

設計についてはdocs/superpowers/specs/2026-08-19-spec-room-design.mdを参照してください。それとその隣の計画は、プロジェクトの最初の名前で書かれた日付入りの記録であり、当時のまま残されています。