spotify/portal-ai-plugins

Spotify Portal AI Plugins

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.

Highlights

• Set up the Portal CLI for your current coding-agent environment.
• Run read-only diagnostics to verify plugin, CLI, authentication, and action readiness.
• Search the software catalog and technical documentation using natural language queries.
• Generate concise service briefings with available ownership, health, incident, and documentation details.
• Discover and safely invoke Portal actions with built-in help, dry-run, and confirmation safeguards.

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.

Installation

Claude Code

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

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.

Cursor

Register the spotify/portal-ai-plugins repository in your Cursor team marketplace, then install Spotify Portal from Cursor Settings → Plugins.

Workflows

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

Portal CLI

The workflows invoke the upstream CLI through:

npx @spotify/portal-cli 

Setup verifies the required auth, actions, owner, search, and service commands before proceeding.