Portal AI Plugins

// Overview

Portal AI Plugins is Spotify's marketplace of plugins that bring Portal — its commercial distribution of Backstage — into the coding agent a developer already uses. The plugins wrap the Portal CLI so an agent can search the software catalog and internal documentation in plain language, produce a briefing on a service with its ownership and health data, and discover and invoke Portal actions with safeguards around them. Setup and diagnostics are part of the same surface: the plugin can check that it, the CLI and your authentication are all ready before you rely on it.

The marketplace carries two plugins. The main one, Spotify Portal, is available for Claude Code, Codex and Cursor and covers the Portal CLI workflows above. The second, shunt, is Claude Code only and does something different: it delegates the I/O-heavy parts of an agent session — bulk file reads and boilerplate generation — to AiKA modes running on a cheaper model, so those tokens never pass through the frontier model. Spotify measured a mean saving of about 90% on bulk reads against a Java monorepo.

AiKA modes are what makes the delegation configurable rather than hard-coded. A mode is a declarative agent on an ephemeral runtime: you write the instructions, pick the model, set parameters such as temperature, and attach MCP tools, and Portal handles the runtime. Shunt ships two public modes — bulk-reader, which summarises several large files to answer a question, and code-writer, which generates boilerplate matching existing patterns — both defaulting to Gemini 2.5 Flash, with a configurable file-size threshold (350 lines by default) deciding what gets handed off.

// What it does

• A plugin marketplace installable straight from GitHub into Claude Code, with Codex and Cursor registering the same repository in team marketplace settings
• Natural-language search across the Portal software catalog and internal documentation from inside the coding agent
• Service briefings that pull ownership and health data for a component without leaving the terminal
• Portal action discovery and invocation with safeguards, plus a diagnostic that checks plugin, CLI and authentication readiness
• shunt: a Claude Code plugin that routes bulk file reads and boilerplate generation to cheaper AiKA modes instead of the frontier model
• Two ready-made public modes — bulk-reader and code-writer — that default to Gemini 2.5 Flash but accept any model configured in AiKA

// Getting started

The plugins drive the upstream Portal CLI through npx @spotify/portal-cli, so you need a Spotify Portal instance to authenticate against. Installation differs by coding agent.

claude plugin marketplace add spotify/portal-ai-plugins
claude plugin install portal@portal

/portal:setup

Commands and code are distilled from the project's own documentation — always check the official repo for the latest.

// When to use it

• Ask a coding agent who owns a service and how it is doing, answered from the Portal catalog rather than guesswork
• Cut the token bill on a large monorepo by sending bulk file reads to a cheap worker model instead of the frontier one
• Search internal documentation in plain language without leaving the terminal or opening the Portal web UI
• Let an agent discover and run approved Portal actions with guardrails, instead of hand-copying commands from a runbook

// How Portal AI Plugins compares

Portal AI Plugins alongside other open-source agent skills & plugins tools AI/TLDR tracks, ranked by GitHub stars.