Primeros pasos

Esta guía te lleva de cero a chatear con tu primer agente de IA a través de ADHDev. Debería tomar unos cinco minutos.

ADHDev se ejecuta en dos modos. Elige uno antes de empezar — el comando de instalación es el mismo, pero la URL del panel y el flujo de cuenta difieren.

	Standalone	Cloud
Cuenta	Ninguna	GitHub o Google
Panel	http://localhost:3000	https://adhf.dev
Mejor para	Máquina única, uso local, privacidad	Multimáquina, acceso remoto, compartir

Si no estás seguro, empieza con Standalone. Puedes cambiar más tarde sin desinstalar.

---

Paso 1 — Instala el CLI

Ejecuta el script de instalación. Detecta tu plataforma, instala Node.js si es necesario y pone el CLI adhdev en tu PATH.

macOS / Linux:

curl -fsSL https://adhf.dev/install | sh

Windows (PowerShell):

irm https://adhf.dev/install.ps1 | iex

Vía npm (cualquier plataforma):

npm install -g adhdev

WARNING

En Windows, la instalación global de npm en Node.js 24+ no es compatible actualmente. El instalador de PowerShell arranca un runtime portátil Node.js 22 por ti.

Lo que debería suceder:

adhdev --version

imprime un número de versión. Si obtienes command not found, abre una nueva ventana de terminal — el instalador registra el PATH de forma permanente (User scope), por lo que sobrevive a reinicios. Si sigue fallando tras un reinicio, consulta Solución de problemas de PATH en Windows.

Luego ejecuta el asistente de primera ejecución:

adhdev setup

Para Standalone, elige la opción solo local — no se requiere inicio de sesión en el navegador. Para Cloud, el asistente abre una pestaña del navegador para la autorización de dispositivo contra adhf.dev. Inicia sesión con GitHub o Google.

TIP

El inicio de sesión en la nube requiere un correo verificado del proveedor OAuth. Si tu cuenta de GitHub/Google no tiene un correo verificado, el inicio de sesión se rechazará en lugar de adivinar qué cuenta vincular.

Lo que debería suceder: El asistente imprime Setup complete y te dice qué comando inicia el daemon.

---

Paso 2 — Abre el panel

Standalone

adhdev standalone

El comando standalone inicia tanto el daemon (localhost:3847) como el panel (localhost:3000).

Abre http://localhost:3000 en tu navegador.

Lo que debería suceder: Se carga un panel que muestra una lista de máquinas vacía con tu máquina local "online". Sin pantalla de inicio de sesión.

Si quieres acceso LAN desde otro dispositivo en tu red:

adhdev standalone --host 0.0.0.0 --token <some-secret>

Cloud

adhdev daemon

El daemon se conecta a api.adhf.dev, registra esta máquina e imprime su ID de máquina.

Abre https://adhf.dev en tu navegador. Inicia sesión si se te solicita.

Lo que debería suceder: La lista de máquinas del panel muestra tu máquina como online en unos segundos, con un indicador verde. Verás "P2P connected" una vez que se establezca el canal WebRTC.

Si la máquina no aparece:

adhdev doctor

Esto revisa el proceso del daemon, la conexión WebSocket y el registro de proveedores local. La mayoría de los problemas se marcarán con una corrección específica.

---

Paso 3 — Elige un proveedor

Un proveedor es el adaptador de ADHDev para un agente de IA. Dos categorías importan para el primer uso:

• Proveedores CLI — agentes basados en terminal como Claude Code, Codex CLI, Antigravity CLI, Hermes CLI. El daemon los ejecuta bajo un PTY y canaliza la terminal al panel.
• Proveedores IDE — editores en ejecución como Cursor, VS Code, Antigravity, Windsurf. El daemon se adjunta a través del Chrome DevTools Protocol (CDP) y lee / escribe el panel del agente dentro del IDE.

Para ver lo que ADHDev detecta en tu máquina:

adhdev detect

Lo que debería suceder: Una lista con installed: yes/no para cada proveedor conocido. Cualquiera marcado como yes está listo para lanzarse.

Puntos de partida recomendados

Para el primer arranque más fluido, elige el que ya tengas instalado:

1. Claude Code (CLI) — adhdev launch claude
2. Codex CLI — adhdev launch codex
3. Cursor (IDE) — adhdev launch cursor

adhdev launch abre el agente bajo el daemon. Para los IDEs relanza el editor con CDP habilitado.

WARNING

adhdev launch <ide> cerrará y reabrirá el IDE para que pueda iniciarse con CDP habilitado. Guarda tu trabajo primero.

Lo que debería suceder: El panel genera una nueva tarjeta para el agente (o una nueva pestaña dentro de la vista de la máquina) y muestra su salida de terminal o estado de IDE en tiempo real.

---

Paso 4 — Envía tu primer prompt

En el panel, haz clic en la tarjeta del agente que acabas de lanzar. Obtendrás una de dos vistas:

• Vista CLI — una terminal en vivo con una casilla de entrada en la parte inferior. Escribe un prompt y presiona Enter (o haz clic en Enviar) exactamente como lo harías en la terminal local.
• Vista IDE — un panel de chat que refleja el panel del agente dentro de tu editor. Escribe un prompt y haz clic en Enviar.

Prueba algo simple:

Lista los archivos en el directorio actual y dime qué tipo de proyecto es este.

Lo que debería suceder:

• El proveedor transmite la respuesta del agente al panel en tiempo real.
• Para agentes CLI, ves los mismos tokens que verías en la terminal local.
• Para agentes IDE, la burbuja de chat se actualiza a medida que el modelo genera.
• Cualquier prompt de herramienta / aprobación que el agente plantee se refleja en el panel con los mismos botones de aprobar/denegar.

Si ves que el prompt llega pero no hay respuesta, revisa:

adhdev status         # daemon healthy?
adhdev provider list  # provider loaded?
adhdev doctor         # any auth or network issue?

Si el propio agente pide una clave de API o inicio de sesión (Anthropic, OpenAI, Google, etc.), gestiónalo en la propia UI del agente o en ~/.config. ADHDev no almacena ni proxifica esas credenciales — cada herramienta mantiene su propia autenticación.

---

Ya estás listo

Ahora tienes un daemon en ejecución, el panel conectado y al menos un agente respondiendo a través del transporte de ADHDev.

A dónde ir después

• Guía del panel — paneles, conmutador de máquinas, compartir sesiones
• Agentes CLI — gestionar sesiones PTY, scrollback, reinicio
• Vista remota — controlar un IDE desde un dispositivo diferente (solo Cloud)
• Multimáquina — vincular portátil + escritorio + máquina de trabajo (solo Cloud)
• Compatibilidad y advertencias — qué está verificado vs. qué es experimental
• Solución de problemas — fallos comunes y soluciones

Profundizar más

• Guía de proveedores — escribe un proveedor personalizado
• Provider SDK — manifest, primitivas TUI, depuración
• Arquitectura — daemon, panel, P2P, servidor (fuente canónica para valores de infraestructura y timing)

Desinstalar

adhdev uninstall     # stops the daemon, removes ~/.adhdev/
npm uninstall -g adhdev   # also removes the CLI itself

Para cambiar de cuenta sin perder el estado local, usa adhdev logout en su lugar.