Compatibilidad y advertencias
ADHDev incluye un amplio inventario de proveedores integrados, pero la compatibilidad debe leerse de forma conservadora. Esta página es la forma más rápida de establecer expectativas antes de depender de un flujo de trabajo específico.
Inventario primero, verificación después
Usa esta regla general:
- Integrado significa que el proveedor existe en el inventario incluido.
- Verificado significa que el proveedor ha sido probado manualmente y promovido.
- Hasta que un proveedor se promueva, trátalo como no verificado incluso si aparece en los lanzadores, la documentación o la página de capacidades.
Puntos de partida prácticos
Si estás evaluando ADHDev para uso real, empieza con proveedores que ya tengan evidencia pública Partial en lugar de solo presencia en el inventario.
Flujos de trabajo de IDE
- Cursor
Cursor es actualmente el punto de partida público más claro para control estilo IDE, Vista remota y cambio de sesión.
Flujos de trabajo de extensión
- Extensión de Codex
Esta es la ruta de extensión con la evidencia pública actual más sólida. Otras extensiones pueden seguir apareciendo en el inventario o en las superficies de lanzamiento, pero deben tratarse como exploratorias hasta que se promuevan.
Flujos de trabajo CLI
- Claude Code
- Codex CLI
Estos se ejecutan a través del stack alojado PTY/session-host y suelen ser el lugar más fácil para validar los flujos de monitoreo y recuperación remotos.
Advertencias conocidas
El soporte de IDE es primero Electron
ADHDev depende del Chrome DevTools Protocol para el control de IDE. Eso significa que los IDEs basados en Electron son el objetivo principal hoy.
- Conjunto objetivo Electron-first hoy: Cursor, Windsurf, Kiro, PearAI, Antigravity, Trae
- Cobertura de detección/lanzamiento: VS Code, VSCodium
- No apto hoy: IDEs no basados en Electron como Zed, IntelliJ y aplicaciones de escritorio nativas similares
La familia VS Code no es lo mismo que Cursor/Windsurf
VS Code y VSCodium se pueden detectar y lanzar, pero no son lo mismo que un IDE de IA integrado nativo. Se vuelven mucho más relevantes cuando añades un flujo de extensión como Cline, Roo Code, Codex o Claude Code.
Trae tiene una advertencia real
Trae funciona para chat y control, pero sus controles de modelo y modo aún dependen de la interacción genérica de UI y pueden fallar según la versión y el diseño de la aplicación.
En la práctica:
- Leer el chat funciona
- Enviar mensajes funciona
- La vista remota funciona
- El cambio de modelo y de modo deben tratarse como parciales
Algunos agentes ACP dependen de flags experimentales upstream
Algunos adaptadores ACP dependen de características upstream que sus propias herramientas todavía marcan como experimentales.
- Gemini CLI (ACP) actualmente arranca con
--experimental-acp - Qwen Code (ACP) actualmente arranca con
--experimental-skills
Estos pueden ser útiles, pero deben tratarse como experimentales en lugar de opciones seguras por defecto.
La autenticación sigue siendo específica de la herramienta
ADHDev no reemplaza el flujo de inicio de sesión propio de cada herramienta.
- Los agentes CLI y ACP siguen requiriendo sus propias claves de API o estado de inicio de sesión
- Una clave de API faltante puede verse como un fallo de lanzamiento si aún no has autenticado la herramienta subyacente
- Esto es especialmente importante para Gemini, Claude, Codex y muchos agentes ACP
Las notificaciones push dependen de la plataforma
Las notificaciones push funcionan mejor cuando el panel se instala como PWA.
- iOS requiere la ruta de instalación PWA para web push
- Los botones de acción de notificación no se muestran de forma consistente en todas las plataformas
- La notificación en sí puede llegar incluso cuando los botones de acción no están disponibles
Windows actualmente bloquea Node.js 24+
ADHDev actualmente trata Windows + Node.js 24+ como no compatible para la instalación e inicio normal del CLI de npm/global.
- El instalador de una línea de PowerShell ahora arranca un runtime portátil Node.js 22 cuando detecta esta combinación
- Si planeas usar
npm install -g adhdevdirectamente en Windows, usa Node.js 22.x - Esta es una salvaguarda temporal hasta que la ruta PTY/session-host de Windows sea estable en versiones más recientes de Node
Linux sigue siendo inventario-primero
Algunas tablas de documentación e inventario mencionan Linux porque el inventario de proveedor/detector incluido incluye nombres de proceso orientados a Linux, puertos y rutas de comando estilo Unix.
Eso no debe leerse todavía como una promesa de soporte público.
- Las rutas de instalación probadas públicamente actuales son macOS y Windows
- Linux aún no se ha validado lo suficiente para presentarse como una ruta compatible
- Si experimentas en Linux hoy, trátalo como no validado y espera solución de problemas manual
Expectativas de Cloud vs Standalone
Cloud
Usa la nube cuando necesites:
- Acceso desde fuera de tu red local
- Notificaciones push
- Gestión multimáquina
- Claves de API y webhooks
Standalone
Usa standalone cuando necesites:
- Una configuración solo local
- Sin dependencia de la nube
- Monitoreo y control basados en LAN
Standalone es excelente para usuarios de OSS y equipos locales, pero las funciones exclusivas de la nube como notificaciones push y acceso remoto orientado a internet no forman parte de esa ruta.
Qué suele funcionar mejor hoy
Si quieres la primera impresión más representativa del producto, estas siguen siendo las rutas de partida más seguras:
- Cursor en escritorio, opcionalmente con aprobaciones móviles o Vista remota
- Extensión de Codex dentro de un IDE anfitrión compatible si específicamente quieres un flujo de trabajo de extensión
- Claude Code o Codex CLI a través de la terminal del panel
- Una máquina con un IDE primero, luego multimáquina después de que lo básico se sienta estable
Dónde revisar el estado actual
Para la lista promovida actual y el estado categoría por categoría, usa Proveedores compatibles. Esa página es la referencia pública de lo que está meramente presente en el inventario frente a lo que tiene validación explícita detrás.