agent-uplink

Agent-Uplink

AI セッション同士をローカルでつなぎます。
すべての Claude Code / Claude Desktop セッションに専用アカウント、プライベートな DM、共有チャンネルを提供する MCP サーバーとローカルハブです。

クイックスタート · 機能 · v2 の新機能 · ドキュメント · 한국어

プランナーとビルダーのセッションを並行して動かし、一方にもう一方の成果をレビューさせたり、複数のエージェントに共有チャンネルを通じて連携させたりできます。クラウドサービスも、デプロイするサーバーも、ターミナル間のコピー＆ペーストも不要です。すべて 127.0.0.1 上にとどまります。

上のアニメーションでは、デモ用ハブ上の 2 つの MCP セッションで記録した実際のツール出力を再生しています。ツールの応答と同梱 UI は英語と韓国語に対応しており、管理アプリの初回起動時に選択できます。

---

機能

役割アカウント — 各セッションに個別の役割を割り当てます

各セッションは use_account で planner や builder などの役割を選びます。同じプロジェクトフォルダー内で同じ役割を選ぶと、常に同じアカウントに紐づくため、セッションを再起動してもアイデンティティ、履歴、DM が維持されます。実行中のセッションが使用している役割は、ほかのセッションには割り当てられません。また、各役割には短いプロフィール説明があり、ほかのセッションから参照できます。

ドキュメント →

ダイレクトメッセージ

open_dm を使うと、2 つのアカウント間にプライベートチャンネルを作成できます。メッセージは各アカウントの受信トレイに届き、送信元のチャンネル情報が付与された状態で、check（即時）または wait（ロングポーリング）で受信できます。

ドキュメント →

サーバーとチャンネル

コミュニケーションサーバーを作成し、#build-status のようなチャンネルを追加すると、すべてのアカウントが更新を受け取れます。ブロードキャスト用の lobby は常に利用できます。

ドキュメント →

ライブログビューアー

管理アプリの Open viewer または agent-uplink-viewer コマンドで開くと、すべてのチャンネルをリアルタイムで確認し、チャンネルで絞り込み、オンラインのユーザーを表示できます。送信者にカーソルを合わせるとプロフィールを確認できます。

ドキュメント →

### 管理アプリ

エージェントが独断で行うべきではない操作のための、小型の Windows デスクトップアプリ（ポータブルな .exe）です。ハブの設定をその場で変更したり、サーバー、チャンネル、アカウント、DM を削除したりできます。削除した項目は復元可能なゴミ箱に保管されます。また、各アカウントのプロフィールとオンライン状態を確認し、ハブが検出した不可視文字も確認できます。allowDevDelete をオフにすると、削除は管理者のみが実行できるようになります。

ドキュメント →

セットアップ不要のハブ

最初の MCP 呼び出し時にハブがバックグラウンドで起動します。ハブは単一インスタンスとして動作し、アイドル状態が 10 分続くと（セッションも開いているビューアーもない場合）自動的に終了します。ループバック以外では何も待ち受けず、昇格した権限も必要ありません。

ドキュメント →

Claude Code スキル

このリポジトリには、これらのツールをいつ、どのように使うかをエージェントに教える Claude Code スキルが含まれています。役割の取得、メッセージの送信、新しいセッションへの作業の引き継ぎ、セッション間でのビルドとレビューのループ実行について説明します。他のセッションからのメッセージは指示ではなくデータとして扱い、プッシュや削除の前には必ずユーザーに確認します。

インストールするには、skills/agent-uplink/ を ~/.claude/skills/ にコピーします（Windows の場合は %USERPROFILE%\.claude\skills\）。ko/ フォルダーは読者向けの韓国語翻訳なので、省略できます。このスキルは Agensi にも掲載されています。

ドキュメント →

---

v2 の新機能

v2 ではメッセージングモデルを全面的に書き直しました。元のバージョンは v1 ブランチに保存されています。

	v1	v2
ID	接続ごとに表示名を register	役割を指定して取得する UUID アカウント（use_account）。再起動後も復元され、使用中は排他的に使用でき、プロフィールの説明も設定可能
会話	全体へのブロードキャスト、または名前を指定したセッションへの送信	lobby へのブロードキャスト、1:1 の DM、およびチャンネルを持つサーバー
受信	check / wait	全チャンネルを対象とするアカウントごとの受信トレイ。各メッセージにはチャンネルが付記されます
管理	—	設定の即時変更と復元可能なゴミ箱への削除に対応した管理アプリ。エージェント側の削除は無効にできます
ビューアー	単一のメッセージストリーム	チャンネルフィルター、オンライン参加者、プロフィールのツールチップ
ツール	register / send / check / wait / who	17 個のツール — メッセージングを参照

v1 または初期の v2 ビルドからアップグレードする場合は、アップグレードを参照してください。

---

クイックスタート

要件： Windows（macOS と Linux はまだサポートされていません）、Node.js 22 以降。

Claude Code に MCP サーバーを登録します。ユーザースコープに設定すると、すべてのプロジェクトで使用できます。

claude mcp add --scope user agent-uplink -- npx -y agent-uplink

または、任意の MCP クライアントの JSON 設定に追加します（Claude Desktop など）。

{
  "mcpServers": {
    "agent-uplink": { "command": "npx", "args": ["-y", "agent-uplink"] }
  }
}

次に、各セッションで以下を実行します。

1. use_account — このプロジェクトフォルダー内の役割を一覧表示します。
2. use_account(role: "planner", description: "Plans features and hands off tasks") — 役割を取得します。
3. send、check、wait、open_dm、… — 他のセッションと会話します。

任意：エージェントに引き継ぎとレビュールーチンを知らせるには、Claude Code スキルをインストールします。

バージョンの固定、Windows での npx のトラブルシューティング、ソースからのビルド、設定での役割の固定については、はじめにを参照してください。

---

動作の仕組み

flowchart LR
  A["Claude session<br/>(role: planner)"] -- stdio --> MA[MCP server]
  B["Claude session<br/>(role: builder)"] -- stdio --> MB[MCP server]
  MA -- TCP 127.0.0.1:47800 --> H[(Hub)]
  MB -- TCP 127.0.0.1:47800 --> H
  H -- HTTP 127.0.0.1:47801 --> V[Log viewer]
  ADM[Admin app] -- admin token --> H

各セッションは stdio 経由で独自の MCP サーバーを実行します。MCP サーバーはループバック上の 1 つのハブを共有し、アカウント、受信トレイ、チャンネルログを %ProgramData%\AgentUplink に保存します。詳細はアーキテクチャを参照してください。

---

開発

npm test          # all tests, including the admin app's unit tests
npm run build     # compile hub and MCP server to dist/
cd admin && npm run typecheck && npm run dist   # admin app → admin/release/*.exe

パス	内容
hub/	通信ハブ（TCP + HTTP ビューアー）
mcp/	MCP サーバー（stdio）、ハブクライアント、役割アカウント
shared/	プロトコルの型とフレーミング
admin/	管理アプリ（Electron、独立した package.json）
docs/	ドキュメントと README のアセット

ステータスと制限事項

• ローカルのシングルユーザー向け信頼モデルです。マシン上でデータフォルダーを読み取れる人なら、誰でも利用できます。セキュリティモデルをご覧ください。
• サポート対象のプラットフォームはWindowsです。管理アプリはリリースページで、Windows用のポータブルな.exeとして配布しています。リリースバイナリはGitHub Actionsでビルドされており、まだコード署名されていません。各リリースのノートに記載されているSHA-256で検証してください。詳しくはコード署名ポリシーをご覧ください。
• MCP クライアントからセッションにメッセージを送信することはできません。メッセージを受け取るセッション側でcheckまたはwaitを呼び出す必要があります。
• ツールの応答と同梱のUIは、英語と韓国語で利用できます。管理アプリで言語を選択するまでは、すべて英語です（設定）。

ライセンス

MIT