站内导读
定位:Spotify 开源的 Portal AI 插件集,把 Portal CLI 的工作流接入 Claude Code、Codex、Cursor 和 pi,在编码环境里完成鉴权配置、目录查询与服务简报。
核心能力
- 提供 setup、doctor、search、service、actions、feedback 等工作流,按任务拆成独立命令。
- doctor 只做只读诊断,检查插件、CLI、鉴权与 action 的就绪情况。
- 调用 Portal action 前可查看内置帮助、做 dry-run 预览并二次确认,减少误操作。
- Fleetshift 系列覆盖建 shift、触发与限时监控、查进度、排障、完成后开 PR。
适用人群:适合已在使用 Spotify Portal 的研发与运维团队,需先装好对应 coding agent,并具备 Portal CLI 的认证与软件目录访问权限。
位置づけ:Spotify がオープンソースで公開する Portal AI プラグイン集で、Portal CLI のワークフローを Claude Code、Codex、Cursor、pi に取り込み、コーディング環境の中で認証設定、カタログ検索、サービスブリーフィングを行えるようにします。
主な機能
- setup、doctor、search、service、actions、feedback などのワークフローを、タスクごとに独立したコマンドとして提供します。
- doctor は読み取り専用の診断のみを行い、プラグイン、CLI、認証、action の準備状況を確認します。
- Portal action を実行する前に、組み込みヘルプの確認、dry-run によるプレビュー、再確認ができ、誤操作を減らせます。
- Fleetshift 系は shift の作成、トリガーと時間制限付きの監視、進捗確認、トラブルシューティング、完了後の PR 作成をカバーします。
向いている人:すでに Spotify Portal を使っている開発・運用チームに向きます。対応するコーディングエージェントのインストールと、Portal CLI の認証およびソフトウェアカタログへのアクセス権限が必要です。
정의: Spotify가 오픈소스로 공개한 Portal AI 플러그인 모음으로, Portal CLI 워크플로를 Claude Code, Codex, Cursor, pi 안으로 가져와 코딩 환경에서 인증 설정, 카탈로그 검색, 서비스 브리핑을 수행할 수 있게 합니다.
핵심 기능
- setup, doctor, search, service, actions, feedback 등의 워크플로를 작업별 독립 명령으로 제공합니다.
- doctor는 읽기 전용 진단만 수행하며 플러그인, CLI, 인증, action의 준비 상태를 점검합니다.
- Portal action을 호출하기 전에 내장 도움말 확인, dry-run 미리보기, 재확인이 가능해 실수를 줄일 수 있습니다.
- Fleetshift 계열은 shift 생성, 트리거와 시간 제한 모니터링, 진행 상황 확인, 문제 해결, 완료 후 PR 열기를 다룹니다.
적합한 사용자: 이미 Spotify Portal을 사용 중인 개발 및 운영 팀에 적합합니다. 지원되는 코딩 에이전트를 설치해야 하며 Portal CLI 인증과 소프트웨어 카탈로그 접근 권한이 필요합니다.
What it is: portal-ai-plugins is Spotify's open-source plugin set that brings Portal CLI workflows into Claude Code, Codex, Cursor and pi, so authentication setup, catalog search and service briefings can be done inside the coding environment.
Key capabilities
- Provides workflows such as setup, doctor, search, service, actions and feedback, split into separate commands per task.
- doctor performs read-only diagnostics only, checking the readiness of the plugin, CLI, authentication and actions.
- Before invoking a Portal action you can read the built-in help, preview with a dry run and confirm, reducing mistakes.
- The Fleetshift workflows cover creating shifts, triggering and monitoring them with time limits, checking progress, troubleshooting, and opening a PR when a run completes.
Who it is for: Engineering and operations teams already using Spotify Portal. You need a supported coding agent installed, plus Portal CLI authentication and access to the software catalog.
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.
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.
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 <command>
Setup verifies the required auth, actions, owner, search, and service commands before proceeding.