Spotify Portal AI Plugins

Overview

Spotify Portal AI Plugins brings Spotify Portal into Claude Code, Codex, Cursor, and pi. It provides focused workflows for the Portal CLI covering authentication setup, catalog and documentation search, service briefings, diagnostics, and Portal action invocation. The marketplace also includes shunt, a Claude Code plugin that routes I/O-heavy agent work to AiKA modes through the Portal CLI actions registry.

Key Features

• Set up Portal CLI authentication for the 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 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.

Use Cases

• Searching a software catalog and technical documentation from an AI coding agent.
• Producing concise operational service briefings with ownership, health, incident, and documentation details.
• Verifying plugin, CLI, authentication, and action readiness before using Portal workflows.
• Managing Fleetshift shifts and opening PRs from completed runs.

Getting Started

• In Claude Code, add the marketplace with claude plugin marketplace add spotify/portal-ai-plugins, install portal@portal, optionally install shunt@portal, start a new session, and run /portal:setup.
• In Codex, add the marketplace with codex plugin marketplace add spotify/portal-ai-plugins, open /plugins, install Spotify Portal, start a new task, and ask to set up Spotify Portal.
• In Cursor, register the spotify/portal-ai-plugins repository in the Cursor team marketplace, then install Spotify Portal from Cursor Settings → Plugins.
• In pi, run pi install git:github.com/spotify/portal-ai-plugins, start a new session, and run /skill:setup.

Deployment & Requirements

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

Before You Adopt

• License: Apache-2.0. Review its terms before using, modifying, or distributing the project.
• The plugin workflows depend on the upstream Portal CLI invoked with npx.
• The shunt plugin is currently available only in Claude Code.