spotify/portal-ai-plugins
'%20fill-opacity='.8'%20d='M3.256%203.913a3.083%203.083%200%200%200-.003%204.397L8%2012.998l4.743-4.684a3.085%203.085%200%200%200%20.001-4.4c-.6-.593-1.4-.914-2.233-.914a3.17%203.17%200%200%200-1.91.635L8%204.087l-.601-.452A3.17%203.17%200%200%200%205.489%203c-.834%200-1.634.321-2.233.913m10.19%205.111-4.748%204.69a.996.996%200%200%201-1.397%200L2.549%209.02a4.083%204.083%200%200%201%20.004-5.82A4.17%204.17%200%200%201%205.488%202c.907%200%201.787.29%202.512.835A4.17%204.17%200%200%201%2010.51%202c1.093%200%202.146.422%202.936%201.202a4.085%204.085%200%200%201%200%205.822'%20/%3e%3c/svg%3e)
1'%20stroke-opacity='.75'%20stroke-width='1.5'%20stroke-linejoin='round'/%3e%3c/svg%3e)
Spotify Portal AI Plugins
Bring Spotify Portal into Claude Code, Codex, Cursor, and pi.
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.
- Create, run, check, and troubleshoot Fleetshift shifts, open PRs from completed runs, and stop a run on request.
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 repository in your Cursor team marketplace, then install Spotify Portal from Cursor Settings → Plugins.
pi
pi install git:github.com/spotify/portal-ai-plugins
Start a new session and run:
/skill:setup
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 |
fleetshift-create-shift | Draft and create a Fleetshift shift from a goal, with a dry-run preview |
fleetshift-run-shift | Trigger a shift, monitor it with a bounded wait, and stop it on request |
fleetshift-check-shift | Report a shift's progress, targets, and PRs (read-only) |
fleetshift-troubleshoot-shift | Diagnose failed shift jobs from their status and logs (read-only) |
fleetshift-create-prs | Open PRs for completed shift targets after confirmation |
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.