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ía | Descripción | Ejemplo |
|---|---|---|
ide | Aplicaciones de IDE de escritorio | Cursor, VS Code, Windsurf |
cli | Agentes de IA basados en terminal | Cursor CLI, Claude Code |
extension | Extensiones/plugins de IDE | Cline, 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,PartialoUnverified? - ¿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:
normalcarga la raíz de usuario normal más los proveedores upstream/incluidos.no-upstreamomite la fuente upstream descargada y usa solo las definiciones locales/incluidas.explicit providerDirapunta ADHDev a una raíz de proveedor específica, como un checkout local deadhdev-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 hookstatusLine, 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.
