프로젝트 소개

Spotify Portal AI Plugins는 Spotify Portal을 Claude Code, Codex, Cursor와 같은 코딩 에이전트에 통합하는 플러그인 마켓플레이스 저장소입니다. 그 목적은 npm 패키지로 배포되는 Portal CLI를 중심으로 집중적인 워크플로를 제공하는 것입니다. 이 플러그인은 여러 워크플로를 다룹니다. Setup은 현재 코딩 에이전트 환경에 맞게 Portal CLI 인증을 구성합니다. Doctor는 플러그인, CLI, 인증, 작업 준비 상태를 확인하기 위한 읽기 전용 진단을 실행합니다. Search는 자연어를 사용하여 소프트웨어 카탈로그와 기술 문서를 조회합니다. Service는 소유권, 상태, 인시던트, 문서 세부 정보를 포함할 수 있는 간결한 서비스 브리핑을 생성합니다. Actions는 사용자가 Portal 작업을 발견, 검사, 미리보기, 안전하게 호출할 수 있게 하며, 내장된 도움말, 드라이런, 확인 안전장치를 제공합니다. 피드백 워크플로는 Portal CLI에 대한 피드백을 Portal 팀에 제출합니다. 설치 방법은 에이전트마다 다릅니다. Claude Code의 경우 사용자는 마켓플레이스를 추가하고 portal 플러그인을 설치하며, 선택적으로 shunt 플러그인도 설치한 다음 새 세션에서 setup 명령을 실행합니다. Codex의 경우 사용자는 마켓플레이스를 추가하고, 플러그인 보기를 열고, Spotify Portal을 설치하고, 새 작업을 시작한 뒤 setup을 요청합니다. Cursor의 경우 사용자는 Cursor 팀 마켓플레이스에 저장소를 등록하고 Cursor Settings, Plugins에서 Spotify Portal을 설치합니다. 이 저장소는 또한 현재 Claude Code 전용이라고 설명되는 shunt도 제공합니다. Shunt는 대량 파일 읽기 및 보일러플레이트 생성과 같이 I/O가 많은 에이전트 작업을 Portal CLI actions 레지스트리를 통해 더 저렴한 워커 모델을 실행하는 AiKA 모드로 라우팅합니다. 워크플로는 @spotify/portal-cli 패키지와 함께 npx를 통해 업스트림 CLI를 호출합니다. Setup은 진행하기 전에 필요한 auth, actions, owner, search, service 명령을 확인합니다.