Gestión multimáquina

Solo en la nube

La gestión multimáquina está disponible solo en la versión Cloud. La versión autoalojada admite una sola máquina.

ADHDev Cloud permite que una cuenta haga seguimiento de varias máquinas de desarrollo desde un solo panel.

Lo que te ofrece

• un panel para tu portátil, escritorio, máquina de trabajo o máquina remota
• visibilidad de sesiones consciente de la máquina entre flujos de trabajo de IDE, CLI y ACP
• una página de detalle de máquina con controles de lanzamiento, configuración de proveedores, logs y recuperación de session-host
• acceso a la nube fuera de tu red local

Esta es una de las diferencias más claras entre la nube y el autoalojado. La nube es el plano de control vinculado a la cuenta. El autoalojado es un panel local por máquina.

Cómo funciona

Cada máquina ejecuta su propio daemon de ADHDev, autenticado en la misma cuenta de la nube:

npm install -g adhdev
adhdev setup
adhdev daemon

Una vez que las máquinas están conectadas bajo la misma cuenta, aparecen juntas en el panel.

Repo Mesh (orquestación de daemon a daemon)

Repo Mesh coordina varios daemons de la misma cuenta para que una sesión coordinadora pueda conducir el trabajo entre varias máquinas o worktrees de git. Se ejecuta sobre un DataChannel P2P directo de daemon a daemon (vía node-datachannel); el WebSocket del servidor de la nube solo retransmite la señalización de SDP offer/answer/ICE y autoriza que ambos daemons pertenezcan a la misma cuenta. Esto es coordinación de daemons — no es un fallback de comandos del panel. El tráfico de comandos/datos del panel sigue usando solo el canal P2P panel↔daemon.

El panel de la nube presenta el mesh en la página Repo Mesh (/mesh).

Conceptos centrales:

• Nodo — un workspace que participa en el mesh: un checkout de repo o un worktree de git aislado donde puede ejecutarse un agente.
• Misión — un objetivo que agrupa las tareas que trabajan hacia él y permanece como un registro duradero.
• Tarea — una unidad de trabajo que un agente en un nodo realiza, moviéndose a través de pending → assigned → completed/failed.
• Cola — la lista local del daemon de tareas en espera que los nodos inactivos reclaman de forma autónoma. La cola es local-first y autoritativa; Cloud/D1 solo mantiene metadatos ligeros de membresía/señalización.
• Ledger — el registro de auditoría del mesh, de solo anexión, de lo que ya ha sucedido entre los nodos (historial, no una lista de tareas pendientes). Reconciliado entre daemons sobre porciones acotadas de ledger P2P.
• Refinery — el proceso que converge una rama de worktree de vuelta a su base: validar → merge → push → limpieza.

El daemon coordinador es propietario del snapshot agregado mesh_status. Las sesiones worker son despachadas por el coordinador y auto-aprobadas por defecto. La finalización se basa en evidencia (estado/checkpoint de git, eventos del ledger), no en el autoinforme del LLM. Las herramientas de Repo Mesh se exponen a las sesiones coordinadoras a través del servidor MCP en modo mesh — consulta Servidor MCP.

Para el panorama completo — orquestación basada en pull, colaboración de repo aislada por worktree, convergencia de la refinery y verificación cruzada MAGI — consulta la guía dedicada de Repo Mesh.

Burrows

La página Burrows es la vista general a nivel de máquina. Es donde ves rápidamente:

• qué máquinas están online
• a qué máquina pertenece una sesión
• el estado de conexión y runtime
• qué máquina quieres abrir en detalle

Detalle de máquina

Abrir una máquina te da una vista más operativa que el panel principal:

• Workspace para sesiones actuales de IDE, CLI y ACP
• Hosted Runtimes para diagnóstico y recuperación de runtimes CLI alojados
• Providers para configuración de máquina/proveedor
• System para salud de la máquina
• Logs para logs de runtime y daemon

Esta es la página que usas cuando el panel de alto nivel te dice que algo va mal pero necesitas contexto específico de la máquina.

Usos típicos

Las configuraciones multimáquina en la nube son especialmente útiles cuando:

• mantienes una máquina en trabajo de agente en segundo plano
• separas dispositivos personales y de trabajo
• quieres aprobaciones móviles para sesiones que se ejecutan en otro lugar
• necesitas recuperar un runtime CLI en una máquina que no estás usando físicamente

Límites de plan

Plan	Máx. máquinas
Free	1
Pro	3
Enterprise	Ilimitado

Cuando alcanzas tu límite de máquinas, los registros de máquinas adicionales se rechazan hasta que elimines una o mejores tu plan.

Diferencia con el autoalojado

El autoalojado no fusiona varias máquinas en un solo panel alojado.

Usa el autoalojado cuando quieras un panel solo local para una máquina. Usa la nube cuando quieras visibilidad de máquinas vinculada a la cuenta entre dispositivos.

Nombrar máquinas

Los nombres amigables de máquina importan una vez que tienes más de una máquina conectada.

Los apodos de máquina aparecen por todo el panel y ayudan a desambiguar dónde se está ejecutando realmente una sesión.

Próximos pasos

• Panel →
• Móvil →
• Planes y límites →