Command Reference

Every command available in the Spotify CLI.

Setup & Auth

CommandDescription
spotify setupSet up Spotify API credentials with guided wizard
spotify loginAuthenticate with Spotify via OAuth
spotify daemon:setupSet up the Spotify daemon with all dependencies

Playback

CommandDescription
spotify play "query"Search and play a track, artist, album, or playlist
spotify pausePause playback
spotify resumeResume playback from where it was paused
spotify skipSkip to next track
spotify skip prevSkip to previous track
spotify volume [level]Show or set volume (absolute or relative like +10, -10)
spotify shuffle [on|off]Toggle or set shuffle mode
spotify repeat [off|track|context]Set repeat mode

Information

CommandDescription
spotify currentShow currently playing track
spotify devicesList available Spotify devices
spotify top [tracks|artists]Show your top tracks or artists
spotify recentShow recently played tracks

Queue

CommandDescription
spotify queue "query"Add a track to the queue
spotify queue:showShow upcoming tracks in the queue
spotify queue:fillAuto-fill queue using Spotify's recommendation engine

Discovery & Mood

CommandDescription
spotify discover "query"AI-friendly search combining keywords with listening patterns
spotify chillQueue chill, relaxing music
spotify flowQueue focus/flow state music for deep work
spotify hypeQueue high-energy hype tracks
spotify autopilot --mood=focusAuto-refill queue using mood presets (chill, flow, hype, focus, party, upbeat, melancholy, ambient, workout, sleep)

Interactive

CommandDescription
spotify playerLaunch interactive player with visual controls
spotify inspireDisplay an inspiring quote

Integrations

CommandDescription
spotify slackShare what's playing to Slack
spotify serveRun the Spotify request server (accepts Slack slash commands)
spotify webhook:configureConfigure webhook for event forwarding
spotify webhook:testSend a test ping to the configured webhook

System & Daemon

CommandDescription
spotify daemonManage the Spotify daemon for terminal playback
spotify autopilotRun queue autopilot, or manage its LaunchAgent with --install/--status/--uninstall
spotify nowplayingSync playback to macOS Control Center and enable media keys
spotify watchWatch playback and stream events (track changes, play/pause)
spotify event:emitEmit an event to the event bus
spotify vibesGenerate the vibes page — commits grouped by song
JSON output: Most commands support --json for machine-readable output, useful for scripting and integrations.