Skip to content

マルチマシン管理

Cloud Only

マルチマシン管理は Cloud バージョン でのみ利用可能です。セルフホストバージョンは単一マシンをサポートします。

ADHDev Cloud を使うと、1 つのアカウントで単一のダッシュボードから複数の開発マシンを管理できます。

得られるもの

  • ノート PC、デスクトップ、業務用マシン、またはリモートサーバーのための単一のダッシュボード
  • IDE、CLI、ACP ワークフローにまたがるマシン認識のセッション可視性
  • 起動コントロール、プロバイダー設定、ログ、session-host の復旧を備えたマシン詳細ページ
  • ローカルネットワークの外からのクラウドアクセス

これは、クラウドとセルフホストの最も明確な違いの 1 つです。クラウドはアカウントに紐付いたコントロールプレーンです。セルフホストはマシンごとに 1 つのローカルダッシュボードです。

仕組み

各マシンは、同じクラウドアカウントに認証された独自の ADHDev デーモンを実行します:

bash
npm install -g adhdev
adhdev setup
adhdev daemon

同じアカウントのもとでマシンが接続されると、ダッシュボードに一緒に表示されます。

Repo Mesh(デーモン間オーケストレーション)

Repo Mesh は、同じアカウントの複数のデーモンを調整し、1 つの コーディネーター セッションが複数のマシンや git ワークツリーにわたって作業を駆動できるようにします。これは 直接のデーモン間 P2P DataChannelnode-datachannel 経由)で実行されます。クラウドサーバーの WebSocket は SDP offer/answer/ICE のシグナリングのみを中継し、両方のデーモンが同じアカウントに属していることを認可します。これはデーモンの調整です — ダッシュボードコマンドのフォールバックでは ありません。ダッシュボードのコマンド/データトラフィックは、依然としてダッシュボード↔デーモンの P2P チャネルのみを使用します。

クラウドダッシュボードは、Repo Mesh ページ(/mesh)で mesh を表示します。

中核となる概念:

  • Node — mesh に参加するワークスペース: エージェントが実行できるリポジトリのチェックアウト、または分離された git ワークツリー。
  • Mission — それに向かって作業するタスクをグループ化し、永続的な記録として残る目標。
  • Task — ノード上のエージェントが実行する作業の単位で、pending → assigned → completed/failed を通じて移動します。
  • Queue — アイドルなノードが自律的にクレームする待機タスクのデーモンローカルなリスト。キューはローカルファーストで権威があります。Cloud/D1 は軽量なメンバーシップ/シグナリングメタデータのみを保持します。
  • Ledger — ノード全体ですでに起きたことの追記専用の mesh 監査ログ(履歴であり、To-Do リストではありません)。境界付きの P2P 台帳スライスを通じてデーモン間で照合されます。
  • Refinery — ワークツリーブランチをそのベースに収束させるプロセス: 検証 → マージ → プッシュ → クリーンアップ。

コーディネーターデーモンが集約 mesh_status スナップショットを所有します。ワーカーセッションはコーディネーターによってディスパッチされ、デフォルトで自動承認されます。完了は LLM の自己報告ではなく、証拠ベース(git ステータス/チェックポイント、台帳イベント)です。Repo Mesh ツールは、mesh モードの MCP サーバーを通じてコーディネーターセッションに公開されます — MCP サーバー を参照してください。

全体像 — プルベースのオーケストレーション、ワークツリー分離のリポジトリコラボレーション、Refinery の収束、MAGI のクロス検証 — については、専用の Repo Mesh ガイド を参照してください。

Burrows

Burrows ページはマシンレベルの概要です。次のことをすばやく確認できる場所です:

  • どのマシンがオンラインか
  • セッションがどのマシンに属しているか
  • 接続とランタイムのステータス
  • 詳細を開きたいマシン

マシン詳細

マシンを開くと、メインダッシュボードよりも運用的なビューが得られます:

  • 現在の IDE、CLI、ACP セッションのための Workspace
  • ホスト型 CLI ランタイムの診断と復旧のための Hosted Runtimes
  • マシン/プロバイダー設定のための Providers
  • マシンのヘルスのための System
  • ランタイムおよびデーモンのログのための Logs

これは、高レベルのダッシュボードが何かおかしいと教えてくれるが、マシン固有のコンテキストが必要なときに使うページです。

一般的な使い方

マルチマシンのクラウドセットアップは、特に次のような場合に便利です:

  • 1 台のマシンをバックグラウンドのエージェント作業に専念させる
  • 個人用と業務用のデバイスを分ける
  • 別の場所で実行中のセッションに対するモバイル承認が欲しい
  • 物理的に使っていないマシンの CLI ランタイムを復旧する必要がある

プラン制限

プラン最大マシン数
Free1
Pro3
Enterprise無制限

マシン制限に達すると、1 つを削除するかアップグレードするまで、追加のマシン登録は拒否されます。

セルフホストとの違い

セルフホストは、複数のマシンを 1 つのホスト型ダッシュボードに統合しません。

1 台のマシンのためのローカル専用ダッシュボードが欲しいときはセルフホストを使ってください。複数のデバイスにまたがるアカウント連携のマシン可視性が欲しいときはクラウドを使ってください。

マシンの命名

複数のマシンを接続すると、分かりやすいマシン名が重要になります。

マシンのニックネームはダッシュボード全体に表示され、セッションが実際にどこで実行されているかを明確に区別するのに役立ちます。

次のステップ

ホスティングされたクラウドのドキュメントはこちらです。オープンソースおよびセルフホストのドキュメントは OSS リポジトリにあります。