portal-ai-plugins README

The project's README from github.com/spotify/portal-ai-plugins. As one markdown file: README.md.

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

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

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

portal-ai-plugins (spotify/portal-ai-plugins)

Searching Database…

Что это такое?Плагин для Spotify, который добавляет Portal в AI-агенты для кодинга — Claude Code, Codex и Cursor — с воркфлоу для настройки аутентификации, поиска по каталогу, обзоров сервисов, диагностики и действий Portal.
Это отдельное приложение или оно живёт внутри моего агента для кодинга?Оно живёт внутри вашего агента для кодинга: вы устанавливаете его как плагин для Claude Code, Codex или Cursor, а его воркфлоу под капотом вызывают CLI Portal из апстрима.
Как добавить его в Claude Code, Codex или Cursor?В Claude Code откройте новую сессию и выполните команду настройки; в Codex откройте /plugins и установите Spotify Portal; в Cursor зарегистрируйте репозиторий spotify/portal-ai-plugins в маркетплейсе вашей команды и установите его через Cursor Settings.
Нужно ли что-то ещё кроме плагина, например учётные данные Portal?Да — воркфлоу настройки выполняет аутентификацию Portal CLI и проверяет наличие необходимых команд auth, actions, owner, search и service, прежде чем вы сможете продолжить.
У всех агентов для кодинга одинаковый набор возможностей?Не совсем — основные воркфлоу работают во всех трёх агентах, но shunt, дополнительный плагин для выгрузки ресурсоёмких по вводу-выводу задач агента, пока доступен только в Claude Code.
Что такое shunt?Второй плагин в том же маркетплейсе, который перенаправляет ресурсоёмкие по вводу-выводу задачи агента — массовое чтение файлов и генерацию шаблонного кода — в режимы AiKA, где работают более дешёвые модели-воркеры, через реестр действий Portal CLI. Пока работает только с Claude Code.
А что такое Spotify Portal?Судя по README, это платформа, на которой работают ваш каталог ПО и техническая документация, с системой действий (actions) поверх; этот плагин лишь открывает её CLI-воркфлоу вашему агенту для кодинга.
Creator
spotify
Size
0.1 MB
Stars
2.5K
Updated
CommitOct 12
Age
2mo
Commits · 90 Days