portal-ai-plugins

Spotify Portal AI Plugins es un repositorio de marketplace de plugins que integra Spotify Portal en agentes de programación como Claude Code, Codex y Cursor. Su propósito es proporcionar flujos de trabajo enfocados en la CLI de Portal, que se distribuye como paquete npm. El plugin cubre varios flujos de trabajo. Setup configura la autenticación de la CLI de Portal para el entorno actual del agente de programación. Doctor ejecuta diagnósticos de solo lectura para verificar la preparación del plugin, la CLI, la autenticación y las acciones. Search consulta el catálogo de software y la documentación técnica usando lenguaje natural. Service genera informes concisos de servicios que pueden incluir detalles de propiedad, estado, incidentes y documentación. Actions permite a los usuarios descubrir, inspeccionar, previsualizar e invocar de forma segura acciones de Portal, con ayuda integrada, dry-run y salvaguardas de confirmación. Un flujo de feedback envía comentarios sobre la CLI de Portal al equipo de Portal. La instalación varía según el agente. Para Claude Code, los usuarios añaden el marketplace e instalan el plugin portal, opcionalmente también el plugin shunt, y luego ejecutan el comando setup en una nueva sesión. Para Codex, los usuarios añaden el marketplace, abren la vista de plugins, instalan Spotify Portal, inician una nueva tarea y solicitan setup. Para Cursor, los usuarios registran el repositorio en el marketplace de su equipo de Cursor e instalan Spotify Portal desde Cursor Settings, Plugins. El repositorio también incluye shunt, descrito como solo para Claude Code por ahora. Shunt enruta el trabajo del agente con uso intensivo de E/S, como lecturas masivas de archivos y generación de código repetitivo, a modos AiKA que ejecutan modelos de trabajo más económicos a través del registro de acciones de la CLI de Portal. Los flujos de trabajo invocan la CLI upstream mediante npx con el paquete @spotify/portal-cli. Setup verifica los comandos requeridos de auth, actions, owner, search y service antes de continuar.