{"repo":"zcaceres/spotify-cli","free":true,"listed":false,"github":"https://github.com/zcaceres/spotify-cli","clone":"git clone https://github.com/zcaceres/spotify-cli.git","description":"Control Spotify from your AI Agent, easily and securely","language":"TypeScript","stars":11,"topics":["ai-agents","bun","cli","command-line","json","music","oauth2","pkce","playback","spotify"],"license":null,"category":"cli-tools","readme_excerpt":"spotify-cli Secure, agent (and human) friendly CLI for playback, search, playlists, and library management. JSON output. PKCE auth. Documentation · Command Reference · Releases Quick start Install Download the latest binary for your platform from Releases: Or run from source with Bun: Set up a Spotify app 1. Go to developer.spotify.com/dashboard 2. Click Create App , set redirect URI to http://127.0.0.1:8888/callback 3. Copy the Client ID Log in Try it Features - 43 commands — playback, search, library, playlists, albums, user profile - Search-then-act — pass human-readable names where IDs are expected (e.g. spotify queue add \"bohemian rhapsody\" ) - Enriched output — Spotify's API returns opaque IDs for mutations; we resolve them to human/agent-readable names, artists, and albums automatically - JSON to stdout — pipe to jq , scripts, or AI agents - PKCE auth — no client secret, tokens refresh automatically - Structured errors — JSON to stderr with error codes and exit codes - Zero config — single binary, no runtime dependencies Exit codes Code Meaning ------ --------- 0 Success 1 Invalid arguments 2 Auth error 3 Spotify API error 4 Network error Known limitations - track features and track recommendations are restricted for Spotify apps created after November 2024 unless you have extended quota mode approval. - As of February 2026, Spotify apps in development mode can no longer use batch endpoints. The CLI fetches items individually, which works but is slower for large operat","default_branch":null,"files":null,"tree":[],"storefront":"/r/zcaceres","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/zcaceres/spotify-cli/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}