Comandos CLI

Referencia para la herramienta de línea de comandos adhdev para el usuario final.

Comandos globales

`adhdev`

Muestra la ayuda y los comandos disponibles.

`adhdev setup`

Asistente de configuración interactivo. Autentica tu máquina con ADHDev Cloud.

bash

adhdev setup
# Opens browser for device authentication
# Stores token in ~/.adhdev/config.json

`adhdev daemon`

Inicia el proceso del daemon. Se conecta a tus IDEs y al servidor de ADHDev.

bash

adhdev daemon
# Runs in foreground, press Ctrl+C to stop

Si quieres el servidor standalone solo local, usa la documentación de autoalojado en su lugar:

`adhdev standalone`

Inicia el servidor standalone autoalojado: panel local + daemon embebido + namespace de session-host standalone.

bash

adhdev standalone
adhdev standalone --host 0.0.0.0
adhdev standalone --port 8080
adhdev standalone --token mysecret
adhdev standalone --no-open
adhdev standalone --dev

Usa esto cuando quieras explícitamente la ruta autoalojada/solo local en lugar del flujo de daemon conectado a la nube.

Comportamiento importante:

standalone se mantiene solo en localhost por defecto a menos que pases --host
si lo expones en 0.0.0.0 sin autenticación por token o una contraseña de panel, standalone advierte que el panel está abierto a tu LAN
standalone usa su propio namespace de session-host por defecto para no competir con el daemon conectado a la nube por los runtimes alojados en la misma máquina

Para detalles más profundos de autoalojado, consulta:

`adhdev daemon:status`

Muestra el estado actual del daemon y la información de salud local.

bash

adhdev daemon:status
adhdev daemon:status --port 19222

Este comando reporta:

el PID del daemon y la ruta del log
la accesibilidad del IPC local
el estado del session-host cuando está disponible
el estado del fallback directo cuando el IPC del daemon no está disponible

`adhdev status`

Muestra el estado actual de la configuración de la máquina.

bash

adhdev status

Usa esto cuando quieras una respuesta rápida a "¿está esta máquina configurada y con sesión iniciada?" en lugar de diagnósticos de daemon/runtime.

`adhdev mcp`

Inicia el servidor MCP de ADHDev sobre stdio para que los clientes MCP como Claude Desktop puedan inspeccionar y controlar las sesiones de ADHDev.

bash

# Local mode: talks to the standalone daemon on localhost:3847
adhdev mcp
adhdev mcp --port 4000
adhdev mcp --password my-standalone-password

# Mesh mode: coordinator-scoped tools via daemon IPC
adhdev mcp --mode ipc --repo-mesh mesh_abc123

Configuración estilo Claude Desktop:

json

{
  "mcpServers": {
    "adhdev": {
      "command": "adhdev",
      "args": ["mcp"]
    }
  }
}

Herramientas disponibles:

Modo	Herramientas
Local standalone	`list_sessions`, `read_chat`, `send_chat`, `approve`, `screenshot`, `git_status`
Mesh (`--repo-mesh`)	Conjunto de herramientas `mesh_*` con alcance de coordinador

Opciones:

Flag	Descripción
`--mode <mode>`	Modo de transporte MCP: `local` o `ipc`
`--repo-mesh <mesh_id>`	Inicia en modo mesh (herramientas con alcance de coordinador)
`--port <n>`	Puerto del daemon standalone para el modo local (por defecto: `3847`)
`--password <pass>`	Contraseña/token del daemon standalone si está configurado

Comandos de lanzamiento

`adhdev launch [target]`

Lanza o relanza un IDE con CDP habilitado, o inicia un agente CLI a través del daemon en ejecución.

Para los proveedores CLI, un lanzamiento normal es una sesión nueva por defecto. La reanudación/recuperación solo debería suceder cuando elijas explícitamente una sesión guardada o uses la recuperación de runtime alojado a propósito.

bash

# IDEs
adhdev launch cursor          # Launch Cursor (CDP port 9333)
adhdev launch antigravity     # Launch Antigravity (CDP port 9335)
adhdev launch windsurf        # Launch Windsurf (CDP port 9336)
adhdev launch vscode          # Launch VS Code
adhdev launch kiro            # Launch Kiro

# CLI Agents
adhdev daemon                 # Start the daemon once
adhdev launch gemini          # Launch Gemini CLI session
adhdev launch claude          # Launch Claude Code session
adhdev launch codex           # Launch Codex CLI session
adhdev launch aider           # Launch Aider session
adhdev launch cursor-cli      # Launch Cursor CLI session
adhdev launch github-copilot-cli # Launch GitHub Copilot CLI session
adhdev launch goose           # Launch Goose CLI session
adhdev launch opencode        # Launch OpenCode CLI session

Opciones:

Flag	Descripción
`-w, --workspace <path>`	Abrir un workspace/carpeta específico
`-n, --new-window`	Abrir en una ventana nueva

WARNING

adhdev launch para los IDEs cerrará el proceso del IDE existente y lo reabrirá con CDP habilitado. Guarda tu trabajo primero.

Comandos de historial

`adhdev history list <provider>`

Lista el historial CLI/ACP nativo del proveedor guardado para un proveedor.

bash

adhdev history list claude
adhdev history list hermes-cli --json
adhdev history list codex-cli --limit 10 --offset 10
adhdev history list claude --resumable
adhdev history list claude --sort oldest
adhdev history list claude --sort messages
adhdev history list claude --text "reply with exactly" --workspace remote_vs --model gpt-5.4

Usa esto primero cuando tu objetivo real sea:

"¿qué conversaciones puedo continuar?"
"¿qué historial de proveedor tiene el contexto que quiero?"
"¿qué sesión guardada todavía tiene un workspace reanudable?"

Este comando lee los metadatos del historial guardado (providerSessionId, workspace, vista previa, número de mensajes) en lugar de los registros de runtime del session-host.

Filtros y modos de ordenación útiles:

--resumable → muestra solo las entradas que pueden reanudarse inmediatamente sin necesitar --dir
--text <text> → filtra por subcadena de título o vista previa
--workspace <text> → filtra por subcadena de ruta de workspace
--model <text> → filtra por subcadena de modelo
--sort recent → actividad más nueva primero (por defecto)
--sort oldest → actividad más antigua primero
--sort messages → mayor número de mensajes primero

`adhdev history resume <provider> [historySessionId]`

Reanuda una sesión de historial guardado nativa del proveedor.

bash

adhdev history resume claude 20260414_101931_38d017
adhdev history resume hermes-cli 20260413_163128_d61494
adhdev history resume claude --dir /path/to/worktree   # choose interactively when omitted
adhdev history resume claude --resumable --sort messages
adhdev history resume claude --text "sonnet follow-up" --workspace remote_vs --model gpt-5.4

Esta es la ruta de continuidad principal para el uso normal de CLI. Si quieres seguir hablando en la misma conversación del proveedor, prefiere esto sobre el attach/recover de runtime. Si omites historySessionId, ADHDev:

autoselecciona la única entrada de historial guardado reanudable, o
abre un selector interactivo cuando existen varias entradas reanudables.

Controles del selector interactivo:

--resumable → oculta las entradas que todavía necesitan --dir
--text <text> → filtra por subcadena de título o vista previa
--workspace <text> → filtra por subcadena de ruta de workspace
--model <text> → filtra por subcadena de modelo
--sort recent|oldest|messages → usa la misma semántica de ordenación que history list

Si a la entrada guardada le faltan los metadatos del workspace, pasa --dir explícitamente.

Comandos de runtime

`adhdev runtime list`

Lista el estado de recuperación y diagnóstico de runtime alojado usando grupos live/recovery/inactive en lugar de diagnósticos de session-host en bruto.

bash

adhdev runtime list
adhdev runtime list --all
adhdev runtime list --json

Por defecto esto agrupa los registros en:

runtimes en vivo
snapshots de recuperación
registros inactivos cuando se solicita --all

Usa esto primero cuando quieras responder:

"¿qué está realmente en vivo ahora mismo?"
"¿qué puedo recuperar?"
"¿qué registro es solo un snapshot obsoleto?"

`adhdev runtime attach <runtimeTarget>`

Adjunta tu terminal actual directamente a un runtime alojado en vivo.

bash

adhdev runtime attach <runtimeTarget>
adhdev runtime attach <runtimeTarget> --read-only
adhdev runtime attach <runtimeTarget> --takeover

Este comando solo acepta runtimes en vivo. Si el objetivo es un snapshot de recuperación o un registro detenido inactivo, falla rápido y te dice que recuperes o reinicies en lugar de fingir que el objetivo es adjuntable.

`adhdev runtime open <runtimeTarget>`

Abre un workspace de adhmux para un runtime alojado en vivo.

bash

adhdev runtime open <runtimeTarget>
adhdev runtime open <runtimeTarget> --read-only
adhdev runtime open <runtimeTarget> --workspace review-pane

Usa esto cuando quieras explícitamente el flujo de trabajo avanzado de mux/pane. Los flujos normales de attach y recuperación de terminal deberían seguir empezando con adhdev runtime attach, adhdev runtime recover o adhdev runtime restart.

`adhdev runtime recover <runtimeTarget>`

Recupera o reanuda un registro de runtime alojado.

bash

adhdev runtime recover <runtimeTarget>
# alias
adhdev runtime resume <runtimeTarget>

`adhdev runtime restart <runtimeTarget>`

Reinicia un registro de runtime alojado.

bash

adhdev runtime restart <runtimeTarget>

`adhdev runtime stop <runtimeTarget>`

Detiene un registro de runtime alojado.

bash

adhdev runtime stop <runtimeTarget>

`adhdev runtime snapshot <runtimeTarget>`

Imprime el último snapshot de terminal para un registro de runtime alojado.

bash

adhdev runtime snapshot <runtimeTarget>
adhdev runtime snapshot <runtimeTarget> --json

<runtimeTarget> puede ser un ID de sesión, una clave de runtime, un nombre para mostrar o un prefijo único de adhdev runtime list.

Esta es la superficie de recuperación y diagnóstico de runtime alojado. Úsala cuando el propio proceso de runtime necesite recuperación después de una interrupción, no como la forma normal de continuar el historial de conversación del proveedor.

Para las dos acciones de runtime más comunes, también hay atajos de nivel superior:

bash

adhdev attach <runtimeTarget>
adhdev recover <runtimeTarget>
adhdev resume <runtimeTarget>

Estos son atajos directos para adhdev runtime attach y adhdev runtime recover.

Comandos del Session Host

`adhdev daemon:session-host`

Inspecciona y controla el session host local.

Esta es la superficie avanzada de diagnóstico y control de operador detrás de adhdev runtime .... Se desenfatiza intencionalmente de la ayuda principal del CLI porque la mayoría de los usuarios debería empezar primero con la superficie de runtime.

bash

# Show diagnostics snapshot
adhdev daemon:session-host

# Use a non-default daemon IPC port
adhdev daemon:session-host --port 19222

# Print raw diagnostics JSON
adhdev daemon:session-host --json

# Restart a hosted runtime
adhdev daemon:session-host --session <sessionId> --restart

# Resume a runtime
adhdev daemon:session-host --session <sessionId> --resume

# Stop a runtime
adhdev daemon:session-host --session <sessionId> --stop

# Send a signal
adhdev daemon:session-host --session <sessionId> --signal SIGINT

# Force-detach a stuck client
adhdev daemon:session-host --session <sessionId> --detach-client <clientId>

# Prune stale duplicate runtimes for the same provider session
adhdev daemon:session-host --prune-duplicates

# Force write ownership
adhdev daemon:session-host --session <sessionId> --acquire-write <clientId> --owner-type user

# Release write ownership
adhdev daemon:session-host --session <sessionId> --release-write <clientId>

Usa esto cuando las sesiones CLI alojadas estén atascadas, desconectadas o necesiten recuperación manual.

La recuperación de runtime alojado es intencionalmente explícita. El inicio ordinario del daemon no reabre automáticamente las sesiones CLI alojadas a menos que optes por ese comportamiento tú mismo.

Opciones:

Flag	Descripción
`-p, --port <port>`	Puerto IPC del daemon local
`--json`	Imprimir salida JSON
`--limit <count>`	Número de entradas de diagnóstico recientes a incluir
`--session <sessionId>`	Sesión de runtime objetivo
`--restart`	Reiniciar el runtime objetivo
`--resume`	Reanudar el runtime objetivo
`--stop`	Detener el runtime objetivo
`--signal <signal>`	Enviar una señal como `SIGINT` o `SIGTERM`
`--detach-client <clientId>`	Forzar la desconexión de un cliente adjunto específico
`--prune-duplicates`	Eliminar runtimes alojados duplicados obsoletos
`--acquire-write <clientId>`	Forzar la adquisición de la propiedad de escritura para un cliente
`--release-write <clientId>`	Liberar la propiedad de escritura para un cliente
`--owner-type <type>`	Tipo de propietario para `--acquire-write`: `user` o `agent`

Usa esto cuando el estado del session-host y del daemon parezcan desincronizados, cuando un runtime esté atascado en interrupted, o cuando la propiedad de escritura necesite recuperación manual.

Gestión del servicio

`adhdev service install`

Registra el daemon de ADHDev como un servicio en segundo plano del SO que se inicia automáticamente al iniciar sesión.

bash

adhdev service install

Plataforma	Método
macOS	LaunchAgent plist (`~/Library/LaunchAgents/dev.adhf.daemon.plist`)
Windows	VBScript en la carpeta de Inicio (ventana de consola oculta)
Linux	Sin ayudante de auto-instalación integrado

El daemon se reinicia automáticamente si se cae, pero no hace bucle de reinicio si sale limpiamente (p. ej. cuando otra instancia ya está en ejecución).

`adhdev service uninstall`

Elimina el servicio en segundo plano del SO. Un daemon actualmente en ejecución no se ve afectado — deténlo por separado con adhdev daemon:stop.

bash

adhdev service uninstall

`adhdev service status`

Muestra el estado de registro del servicio y la salud del daemon en vivo (PID, tiempo de actividad, memoria, tamaños de log).

bash

adhdev service status
# ✓ Service is installed.
# ✓ Daemon running — PID 12723, uptime 2h 13m, 58 MB
# Logs: stdout 4.2 KB, stderr 0 B

`adhdev service logs`

Ver los logs del servicio del daemon en tiempo real (tail -f).

bash

adhdev service logs             # Follow stdout log
adhdev service logs --err       # Follow stderr log
adhdev service logs -n 50       # Show last 50 lines
adhdev service logs --clear     # Truncate all log files

`adhdev service restart`

Reinicia el daemon a través del servicio del SO. Envía SIGTERM al proceso actual y deja que el gestor de servicios (launchd / inicio de Windows) lo relance. También rota los logs de más de 10 MB.

bash

adhdev service restart

Cuenta y datos

`adhdev logout`

Cierra la sesión de ADHDev. Borra las credenciales de autenticación pero mantiene la configuración del IDE y del workspace.

bash

adhdev logout
adhdev logout -f   # Skip confirmation prompt

`adhdev reset`

Restablece la configuración de ADHDev. Pide confirmación antes de borrar ~/.adhdev/config.json.

bash

adhdev reset

`adhdev uninstall`

Elimina completamente ADHDev del sistema. Detiene el daemon, elimina el servicio en segundo plano del SO y borra todos los datos en ~/.adhdev.

bash

adhdev uninstall
adhdev uninstall -f   # Skip confirmation prompt

Este comando realiza los siguientes pasos:

Detiene el proceso del daemon en ejecución (si hay alguno)
Elimina el servicio en segundo plano del SO (LaunchAgent / script de Inicio)
Borra ~/.adhdev/ — toda la configuración, tokens de autenticación, logs y datos en caché
Imprime instrucciones para terminar con npm uninstall -g adhdev

WARNING

Esto no se puede deshacer. Todas las configuraciones, credenciales y proveedores descargados se eliminarán permanentemente. Usa adhdev logout o adhdev reset si solo quieres borrar la autenticación o la configuración.

Versión y actualización

`adhdev --version`

Muestra la versión actual de ADHDev.

`adhdev update`

Actualiza ADHDev a la última versión y reinicia el daemon. Alias de adhdev daemon:upgrade.

bash

adhdev update
adhdev update --no-restart   # Upgrade only, skip daemon restart

`adhdev daemon:upgrade`

Actualiza el daemon a la última versión.

bash

adhdev daemon:upgrade
# Downloads and installs latest version

`adhdev daemon:api [mode]`

Gestiona el acceso al relay de la REST API del servidor. Deshabilitado por defecto — el tráfico del panel siempre usa P2P/IPC local.

bash

adhdev daemon:api           # Show current status
adhdev daemon:api enable    # Allow server-side REST proxy routes
adhdev daemon:api disable   # Revoke server-side REST proxy routes

Esto solo afecta a las rutas de proxy de la API del servidor. El plano de comandos/datos del panel sigue siendo P2P-first independientemente de esta configuración.

Comandos avanzados

Comandos como adhdev provider ..., adhdev cdp ... y adhdev daemon --dev son principalmente para diagnósticos, trabajo de proveedores o depuración local. Se dejan intencionalmente fuera del flujo de trabajo normal del usuario aquí.

Comandos CLI ​

Comandos globales ​

adhdev ​

adhdev setup ​

adhdev daemon ​

adhdev standalone ​

adhdev daemon:status ​

adhdev status ​

adhdev mcp ​

Comandos de lanzamiento ​

adhdev launch [target] ​

Comandos de historial ​

adhdev history list <provider> ​

adhdev history resume <provider> [historySessionId] ​

Comandos de runtime ​

adhdev runtime list ​

adhdev runtime attach <runtimeTarget> ​

adhdev runtime open <runtimeTarget> ​

adhdev runtime recover <runtimeTarget> ​

adhdev runtime restart <runtimeTarget> ​

adhdev runtime stop <runtimeTarget> ​

adhdev runtime snapshot <runtimeTarget> ​

Comandos del Session Host ​

adhdev daemon:session-host ​

Gestión del servicio ​

adhdev service install ​

adhdev service uninstall ​

adhdev service status ​

adhdev service logs ​

adhdev service restart ​

Cuenta y datos ​

adhdev logout ​

adhdev reset ​

adhdev uninstall ​

Versión y actualización ​

adhdev --version ​

adhdev update ​

adhdev daemon:upgrade ​

adhdev daemon:api [mode] ​

Comandos avanzados ​

Comandos CLI

Comandos globales

`adhdev`

`adhdev setup`

`adhdev daemon`

`adhdev standalone`

`adhdev daemon:status`

`adhdev status`

`adhdev mcp`

Comandos de lanzamiento

`adhdev launch [target]`

Comandos de historial

`adhdev history list <provider>`

`adhdev history resume <provider> [historySessionId]`

Comandos de runtime

`adhdev runtime list`

`adhdev runtime attach <runtimeTarget>`

`adhdev runtime open <runtimeTarget>`

`adhdev runtime recover <runtimeTarget>`

`adhdev runtime restart <runtimeTarget>`

`adhdev runtime stop <runtimeTarget>`

`adhdev runtime snapshot <runtimeTarget>`

Comandos del Session Host

`adhdev daemon:session-host`

Gestión del servicio

`adhdev service install`

`adhdev service uninstall`

`adhdev service status`

`adhdev service logs`

`adhdev service restart`

Cuenta y datos

`adhdev logout`

`adhdev reset`

`adhdev uninstall`

Versión y actualización

`adhdev --version`

`adhdev update`

`adhdev daemon:upgrade`

`adhdev daemon:api [mode]`

Comandos avanzados