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…

2.5K ·GitHub
Portal-ai-plugins
这是什么？一个 Spotify 插件，把 Portal 带进 AI 编程助手——Claude Code、Codex 和 Cursor——提供登录配置、目录搜索、服务简报、诊断以及 Portal 操作等工作流。
它是一个独立应用，还是装在我的编程助手里面？它装在你的编程助手里面：你把它作为插件安装到 Claude Code、Codex 或 Cursor 中，它的工作流会在底层调用上游的 Portal CLI。
怎么把它装进 Claude Code、Codex 或 Cursor？在 Claude Code 中，开一个新会话并运行设置命令；在 Codex 中，打开 /plugins 安装 Spotify Portal；在 Cursor 中，把 spotify/portal-ai-plugins 仓库注册到你的团队 marketplace，然后在 Cursor Settings 里安装。
除了插件本身，我还需要准备什么吗，比如 Portal 凭据？需要——设置工作流会配置 Portal CLI 的登录认证，并验证所需的 auth、actions、owner、search 和 service 命令，然后你才能继续。
每个编程助手的功能都一样吗？不完全一样——主要工作流在三个助手里都能用，但 shunt 这个用来卸载 I/O 密集型助手工作的配套插件，目前只支持 Claude Code。
shunt 是什么？同一个 marketplace 里的另一个插件，它把 I/O 密集型的助手工作——批量读取文件和生成样板代码——通过 Portal CLI 的 actions 注册表，转交给运行更便宜 worker 模型的 AiKA 模式去处理。目前只支持 Claude Code。
Spotify Portal 到底是什么？根据 README 的说法，它是软件目录和技术文档背后的平台，上面还带有一套 actions 系统；这个插件只是把它的 CLI 工作流开放给你的编程助手。
What are similar projects?skills, ownmem, wigolo, open-pstack, claude-plugins-official, headroom, testsprite-cli, copperhead
Which topics is it in?plugin-marketplace, search, cursor, documentation, coding-agent, plugin, codex, claude-code, free, ai-agents, apache-2.0, typescript
Creator
spotify
Size
0.1 MB
Stars
2.5K
Updated
CommitOct 12
Age
2mo
Commits · 90 Days