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. El comando de instalación es el mismo, pero la URL del panel y el flujo de cuenta difieren.

	Cloud	Standalone
Cuenta	GitHub o Google	Ninguna
Panel	https://adhf.dev	http://localhost:3847
Mejor para	Máquinas en distintas redes, acceso remoto, compartir	Uso local, privacidad, emparejar máquinas en una misma red

El camino por defecto abajo es Cloud — es lo que el script de instalación configura automáticamente por ti. Si prefieres quedarte totalmente local sin cuenta, busca el bloque Standalone en el Paso 1 y el Paso 2; es una alternativa totalmente soportada, no una opción de reserva.

---

Paso 1 — Instala el CLI

Ejecuta el script de instalación. Detecta tu plataforma, instala Node.js si es necesario, pone el CLI adhdev en tu PATH y — para Cloud — te guía directamente por el inicio de sesión.

macOS / Linux:

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

Windows (PowerShell):

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

macOS / Linux (Homebrew):

brew tap vilmire/adhdev
brew install adhdev

Homebrew incluye su propio runtime de Node.js, así que esto mantiene adhdev aislado de tu instalación global de npm. (El script de instalación de arriba ya usa Homebrew automáticamente cuando está disponible en macOS.)

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.

Cloud

El script de instalación de arriba ya ejecuta el asistente de configuración por ti (adhdev setup) justo después de instalar — abre una pestaña del navegador para la autorización de dispositivo contra adhf.dev, te hace iniciar sesión con GitHub o Google, registra esta máquina e inicia el daemon. Si eso ya terminó, salta directamente al Paso 3.

Solo necesitas ejecutar el asistente tú mismo si no se ejecutó automáticamente (ADHDEV_NO_SETUP=1, una shell no interactiva, o estás terminando después de arreglar un command not found):

adhdev setup

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, registra la máquina y te pregunta si quieres iniciar el daemon (por defecto: sí).

Standalone

Standalone no usa el asistente de configuración en absoluto — no hay cuenta que crear. Salta directamente al Paso 2 de abajo y ejecuta adhdev standalone directamente.

---

Paso 2 — Abre el panel

Cloud

Si la configuración ya inició el daemon por ti, ya está en ejecución — abre https://adhf.dev en tu navegador e inicia sesión si se te solicita, luego salta a Lo que debería suceder abajo.

Si no, inícialo tú mismo:

adhdev daemon

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

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.

Standalone

adhdev standalone

Esto inicia un único servidor local — daemon y panel juntos — en http://localhost:3847 y lo abre en tu navegador automáticamente.

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>

---

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. 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-cli
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
• 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 (Cloud vinculado a la cuenta; en Standalone, emparejando en una misma red)
• 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

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.