The project's README from github.com/spotify/portal-ai-plugins. As one markdown file: README.md.
Bring Spotify Portal into Claude Code, Codex, and Cursor.
This plugin provides focused workflows for the Portal CLI: set up authentication, search your software catalog, build service briefings, run diagnostics, and invoke Portal actions.
The 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.
claude plugin marketplace add spotify/portal-ai-plugins
claude plugin install portal@portal
claude plugin install shunt@portal # optional: token-saving AiKA delegation
Start a new session and run:
/portal:setup
codex plugin marketplace add spotify/portal-ai-plugins
codex
Open /plugins, install Spotify Portal, start a new task, and ask:
Set up Spotify Portal for me.
Register the spotify/portal-ai-plugins repository in your Cursor team marketplace, then install Spotify Portal from Cursor Settings → Plugins.
| Workflow | Purpose |
|---|---|
setup |
Configure Portal CLI authentication |
doctor |
Run read-only readiness diagnostics |
search |
Search the software catalog and technical documentation |
service |
Produce a concise operational service briefing |
actions |
Discover, inspect, preview, and safely invoke Portal actions |
feedback |
Submit feedback about the Portal CLI to the Portal team |
The workflows invoke the upstream CLI through:
npx @spotify/portal-cli <command>
Setup verifies the required auth, actions, owner, search, and service
commands before proceeding.