멀티 머신 관리

클라우드 전용

멀티 머신 관리는 Cloud 버전에서만 이용 가능합니다. 셀프호스트 버전은 단일 머신을 지원합니다.

ADHDev Cloud를 사용하면 하나의 계정으로 단일 대시보드에서 여러 개발 머신을 관리할 수 있습니다.

제공되는 것

• 노트북, 데스크탑, 업무용 머신 또는 원격 서버를 위한 단일 대시보드
• IDE, CLI, ACP 워크플로우에 걸친 머신 인식 세션 가시성
• 실행 컨트롤, 프로바이더 설정, 로그, 세션-호스트 복구가 있는 머신 상세 페이지
• 로컬 네트워크 외부에서의 클라우드 접근

이것은 클라우드와 셀프호스트의 가장 명확한 차이 중 하나입니다. 클라우드는 계정 연결 제어 플레인입니다. 셀프호스트는 머신당 하나의 로컬 대시보드입니다.

작동 방식

각 머신은 동일한 클라우드 계정에 인증된 자체 ADHDev 데몬을 실행합니다:

npm install -g adhdev
adhdev setup
adhdev daemon

동일한 계정 아래 머신이 연결되면 대시보드에 함께 표시됩니다.

Repo Mesh (데몬 간 오케스트레이션)

Repo Mesh는 동일 계정의 여러 데몬을 코디네이션하여 하나의 코디네이터 세션이 여러 머신 또는 git 워크트리에 걸쳐 작업을 구동할 수 있게 합니다. node-datachannel을 통한 직접 데몬 간 P2P 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 감사 로그 (히스토리, 할 일 목록 아님). 경계 있는 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

높은 수준의 대시보드가 문제를 알려주지만 머신별 컨텍스트가 필요할 때 사용하는 페이지입니다.

일반적인 사용 사례

멀티 머신 클라우드 설정은 특히 다음과 같은 경우에 유용합니다:

• 한 머신은 백그라운드 에이전트 작업에 유지
• 개인 및 업무 장치 분리
• 다른 곳에서 실행 중인 세션에 대한 모바일 승인 원할 때
• 물리적으로 사용하지 않는 머신의 CLI 런타임 복구 필요

플랜 제한

플랜	최대 머신
Free	1
Pro	3
Enterprise	무제한

머신 제한에 도달하면 하나를 제거하거나 업그레이드할 때까지 추가 머신 등록이 거부됩니다.

셀프호스트 차이점

셀프호스트는 여러 머신을 하나의 호스팅 대시보드로 통합하지 않습니다.

한 머신을 위한 로컬 전용 대시보드를 원할 때 셀프호스트를 사용하세요. 여러 장치에 걸친 계정 연결 머신 가시성을 원할 때 클라우드를 사용하세요.

머신 이름 지정

하나 이상의 박스가 연결되면 친근한 머신 이름이 중요해집니다.

머신 닉네임은 대시보드 전체에 나타나며 세션이 실제로 실행 중인 위치를 명확히 구분하는 데 도움이 됩니다.

다음 단계

• 대시보드 →
• 모바일 →
• 플랜 및 제한 →