Proveedores

ADHDev usa un sistema de proveedores para admitir IDEs, herramientas CLI, extensiones y adaptadores ACP a través de un solo panel.

El inventario de proveedores y el soporte verificado se tratan intencionalmente como cosas diferentes:

• inventario: el proveedor existe en el catálogo integrado y ADHDev puede cargarlo
• soporte verificado: el proveedor ha sido probado explícitamente y promovido con evidencia

Categorías de proveedores

Categoría	Descripción	Ejemplo
ide	Aplicaciones de IDE de escritorio	Cursor, VS Code, Windsurf
cli	Agentes de IA basados en terminal	Gemini CLI, Claude Code
extension	Extensiones/plugins de IDE	Cline, Roo Code
acp	Agentes del Agent Client Protocol	35 adaptadores integrados

Cómo funcionan los proveedores

A alto nivel, un proveedor es la capa de integración que le dice a ADHDev cómo:

• detectar la herramienta de destino
• conectarse a ella a través de CDP, PTY o stdio
• leer el chat o el estado de runtime
• enviar entrada o acciones de control
• exponer controles de modelo, modo o aprobación cuando la herramienta los admite

Si esos comportamientos son realmente lo suficientemente fiables para llamarse "compatibles" es una cuestión de verificación separada.

Qué debería importarle a los usuarios

Como usuario final, la pregunta principal no es cómo se implementa el proveedor. Es:

• ¿está el proveedor presente en el inventario integrado?
• ¿está documentado como Verified, Partial o Unverified?
• ¿qué advertencias se aplican a los flujos de trabajo que te importan?

Usa estas páginas para eso:

• Proveedores compatibles
• IDE compatibles
• Compatibilidad y advertencias

Activación de máquina para proveedores CLI y ACP

Para los proveedores de runtime de máquina (cli y acp), el inventario no es lo mismo que la capacidad de lanzamiento en una máquina específica. ADHDev ahora trata estos proveedores como entradas opt-in con alcance de máquina:

1. Abre la pestaña Providers de la máquina.
2. Habilita el proveedor para esa máquina.
3. Ejecuta Detect para que ADHDev verifique el ejecutable configurado en esa máquina.
4. Lánzalo desde el panel o el CLI una vez que la detección tenga éxito.

La tarjeta del proveedor muestra el estado actual de la máquina (Disabled, Enabled, not checked, Not detected o Detected) más los últimos detalles de detección y verificación. Esto evita que un proveedor que meramente existe en el catálogo aparezca como un runtime utilizable hasta que el ejecutable local haya sido realmente comprobado.

La ruta y argumentos del ejecutable personalizados son configuraciones de proveedor locales de la máquina. Úsalos cuando una herramienta esté instalada fuera del PATH predeterminado o necesite un comando envoltorio.

Configuración de fuente de proveedor

La sección Provider source config en la pestaña Providers controla desde dónde se resuelven las definiciones de proveedor:

• normal carga la raíz de usuario normal más los proveedores upstream/incluidos.
• no-upstream omite la fuente upstream descargada y usa solo las definiciones locales/incluidas.
• explicit providerDir apunta ADHDev a una raíz de proveedor específica, como un checkout local de adhdev-providers.

Usa Apply + Reload después de cambiar el modo de fuente o providerDir. La recarga afecta la resolución de proveedores, los flujos de fix/verify y los nuevos lanzamientos. Las sesiones existentes en ejecución pueden necesitar un reinicio para recoger los scripts de proveedor cambiados.

Cuando un proveedor existe pero aun así falla

Un proveedor puede estar presente en el inventario y aun así tener lagunas.

Razones comunes:

• cambios de UI upstream en el IDE o agente
• cobertura parcial del flujo de trabajo
• falta de autenticación en la herramienta subyacente
• un proveedor que está presente pero sigue siendo Unverified
• un proveedor CLI/ACP que no está habilitado o no ha pasado la detección de máquina
• un cambio en la configuración de fuente de proveedor que aún no se ha aplicado/recargado

Si eso sucede, empieza con Problemas de proveedor.