Spotify Mac Skill

This skill provides commands to control Spotify on macOS via AppleScript.

Available Scripts

All scripts are in the ./scripts/ directory (relative to this file). Execute them via bash from the plugin root.

Playback Control

Script	Purpose	Arguments
play.sh	Resume playback	none
pause.sh	Pause playback	none
toggle-playback.sh	Toggle play/pause	none
next-track.sh	Skip to next track	none
previous-track.sh	Go to previous track	none
play-uri.sh	Play specific URI	<spotify_uri> [context_uri]

Search

Script	Purpose	Arguments
search.sh	Open Spotify search visually	<query>

Agent-Assisted Search (Recommended): To search and play automatically, use web search to find Spotify URLs:

1. Search: site:open.spotify.com [query] (e.g., "site:open.spotify.com bohemian rhapsody")
2. Get the URL from results (e.g., https://open.spotify.com/track/6l8GvAyoUZwWDgF1e4822w)
3. Play it: play-uri.sh "https://open.spotify.com/track/..."

This works for tracks, albums, playlists, and artists.

Track Information

Script	Purpose	Arguments
get-current-track.sh	Get current track info	none
get-player-state.sh	Get player state	none

Volume Control

Script	Purpose	Arguments
get-volume.sh	Get current volume	none
set-volume.sh	Set volume level	<volume 0-100>
volume-up.sh	Increase volume by 10	none
volume-down.sh	Decrease volume by 10	none

Position Control

Script	Purpose	Arguments
get-position.sh	Get current position	none
set-position.sh	Seek to position	<seconds>
fast-forward.sh	Forward 10 seconds	none
rewind.sh	Rewind 10 seconds	none

Mode Control

| Script | Purpos...