spotify/portal-ai-plugins
About spotify/portal-ai-plugins
spotify/portal-ai-plugins is an open-source project on GitHub, mainly written in TypeScript. It currently holds 2,904 stars and 228 forks with 13 open issues, and was last pushed on 2026-10-23 (repository created 2026-07-23).
Project Overview
Git Homed tracks it on the Today's Trending board.
GitHub Repository Details
README
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.
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.
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.