Skip to content

Proveedores ​

ADHDev usa un sistema de proveedores para admitir IDEs, herramientas CLI y extensiones 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íaDescripciónEjemplo
ideAplicaciones de IDE de escritorioCursor, VS Code, Windsurf
cliAgentes de IA basados en terminalCursor CLI, Claude Code
extensionExtensiones/plugins de IDECline, Roo Code

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:

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.

Listas de modelos CLI y cuota ​

Para los proveedores CLI, las listas de modelos y las cifras de cuota restante se leen en vivo en lugar de mantenerse a mano cuando la herramienta subyacente lo admite:

  • Listas de modelos: codex-cli, grok-cli, cursor-cli, antigravity-cli, opencode y kimi reportan su propia lista de modelos en tiempo de ejecución (recurriendo al manifiesto si la consulta falla). claude-cli no tiene un comando de listado, así que se usa tal cual la lista del manifiesto.
  • Cuota: adhdev quota <provider> consulta en vivo la propia API de uso del proveedor para antigravity, codex, grok y kimi. Claude Code solo expone el uso a través de su hook statusLine, así que el reporte de cuota para él requiere un envoltorio de suscripción explícita (adhdev quota claude:install) en lugar de algo que el daemon haga automáticamente. Consulta Comandos CLI para la superficie de comandos completa.

Auto-aprobación y prompts de confianza ​

El modo de auto-aprobación es un ajuste por proveedor, declarado en el manifiesto, con valores predeterminados a nivel de repo — responde a los propios prompts de aprobación/confianza de un proveedor sin el flujo del panel botón por botón. La cobertura y el comportamiento varían según el proveedor (los diseños de botones y el texto de los modales de confianza difieren entre CLIs), así que trata la auto-aprobación como algo específico del proveedor y no como un interruptor único y uniforme.

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 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.

La documentación de la nube alojada está aquí. La documentación de código abierto y autoalojada está en el repositorio OSS.