portal-ai-plugins

Overview

A plugin marketplace that integrates Spotify Portal into AI coding agents such as Claude Code, Codex and Cursor. It bundles workflows for authentication setup, catalog search, service briefings, diagnostics and safe action invocation through the Portal CLI.

README Preview

# Spotify Portal AI Plugins\n\nBring [Spotify Portal](https://portal.spotify.com) into Claude Code, Codex, and Cursor.\n\nThis plugin provides focused workflows for the\n[Portal CLI](https://www.npmjs.com/package/@spotify/portal-cli): set up\nauthentication, search your software catalog, build service briefings, run\ndiagnostics, and invoke Portal actions.\n\n## Highlights\n\n- Set up the Portal CLI for your current coding-agent environment.\n- Run read-only diagnostics to verify plugin, CLI, authentication, and action readiness.\n- Search the software catalog and technical documentation using natural language queries.\n- Generate concise service briefings with available ownership, health, incident, and documentation details.\n- Discover and safely invoke Portal actions with built-in help, dry-run, and confirmation safeguards.\n\nThe marketplace also ships **shunt** (Claude Code only for now): a plugin that routes I/O-heavy agent work — bulk file reads and boilerplate generation — to AiKA modes running cheaper worker models, via the Portal CLI actions registry. See [`plugins/shunt/README.md`](plugins/shunt/README.md).\n\n## Installation\n\n### Claude Code\n\n```bash\nclaude plugin marketplace add spotify/portal-ai-plugins\nclaude plugin install portal@portal\nclaude plugin install shunt@portal   # optional: token-saving AiKA delegation\n```\n\nStart a new session and run:\n\n```text\n/portal:setup\n```\n\n### Codex\n\n```bash\ncodex plugin marketplace add spotify/portal-ai-plugins\ncodex\n```\n\nOpen `/plugins`, install Spotify Portal, start a new task, and ask:\n\n```text\nSet up Spotify Portal for me.\n```\n\n### Cursor\n\nRegister the [spotify/portal-ai-plugins](https://github.com/spotify/portal-ai-plugins)\nrepository in your Cursor team marketplace, then install Spotify Portal from\n**Cursor Settings → Plugins**.\n\n## Workflows\n\n| Workflow | Purpose |\n| --- | --- |\n| `setup` | Configure Portal CLI authentication |\n| `doctor` | Run read-only readiness diag