clawtunes

Control Apple Music on macOS via the `clawtunes` CLI (play songs/albums/playlists, control playback, volume, shuffle, repeat, search, catalog lookup, AirPlay...

Security Scan

The skill is internally consistent: it simply wraps the clawtunes Homebrew-installed CLI to control Apple Music on macOS and does not request unrelated credentials or escalate privileges.

Purpose & Capability

Name/description match the required binary and actions. All declared requirements (macOS, clawtunes binary, Apple Music app) are appropriate for controlling Apple Music from the terminal.

Instruction Scope

SKILL.md directs only CLI operations using clawtunes (playback, search, playlists, AirPlay) and briefly notes macOS automation permissions. It does not instruct reading unrelated files, environment variables, or exfiltrating data to external endpoints.

Install Mechanism

Install uses Homebrew with a third‑party tap (forketyfork/tap) and formula 'clawtunes'. This is expected for an external CLI but third‑party taps can install arbitrary code — verify the tap/formula and source (GitHub repo) before installing.

Credentials

No environment variables, credentials, or config paths are requested. The absence of secrets is proportionate to the skill's stated purpose.

Persistence & Privilege

Skill is not 'always: true' and does not request persistent system-wide changes. It may prompt for macOS Automation permission to control Apple Music (normal for this use-case). Agent autonomous invocation is enabled by default but is not unusual.

Assessment

This skill is coherent for controlling Apple Music via the clawtunes CLI. Before installing, verify you trust the Homebrew tap (forketyfork/tap) and review its formula/source on the project GitHub to ensure it matches the published code. Expect macOS Automation permission prompts (System Settings > Privacy & Security > Automation) so the CLI can control Apple Music; grant only if you trust the binary. Because this skill executes a locally-installed binary, avoid installing it from untrusted taps or running unfamiliar versions. Otherwise the skill's requirements and instructions align with its stated purpose.

Apple Music CLI

Use clawtunes to control Apple Music from the terminal. Search and play music, control playback, adjust volume, manage playlists, manage shuffle/repeat, browse the Apple Music catalog, and connect to AirPlay devices.

Setup

• Install (Homebrew): brew install forketyfork/tap/clawtunes
• macOS-only; requires Apple Music app.

Play Music

• Play a song: clawtunes play song "Song Name"
• Play an album: clawtunes play album "Album Name"
• Play a playlist: clawtunes play playlist "Playlist Name"
• Always use the --non-interactive (-N) flag to prevent interactive prompts: clawtunes -N play song "Song Name"
• If the command exits with code 1 and lists multiple matches, retry with a more specific song/album/playlist name.
• If a more specific name still returns multiple matches, use the --first (-1) flag to auto-select the first result: clawtunes -1 play song "Song Name"

Playback Control

• Pause: clawtunes pause
• Resume: clawtunes resume
• Next track: clawtunes next
• Previous track: clawtunes prev
• Show now playing: clawtunes status

Volume

• Show volume: clawtunes volume
• Set volume: clawtunes volume 50
• Adjust volume: clawtunes volume +10 or clawtunes volume -10
• Mute: clawtunes mute
• Unmute: clawtunes unmute

Shuffle and Repeat

• Enable/disable shuffle: clawtunes shuffle on or clawtunes shuffle off
• Set repeat mode: clawtunes repeat off, clawtunes repeat all, or clawtunes repeat one

Search

• Search songs and albums: clawtunes search "query"
• Include playlists: clawtunes search "query" -p
• Songs only: clawtunes search "query" --no-albums
• Limit results: clawtunes search "query" -n 20

Love/Dislike

• Love current track: clawtunes love
• Dislike current track: clawtunes dislike

Playlists

• List all playlists: clawtunes playlists
• Create a playlist: clawtunes playlist create "Road Trip"
• Add a song to a playlist: clawtunes playlist add "Road Trip" "Kickstart My Heart"
• Remove a song from a playlist: clawtunes playlist remove "Road Trip" "Kickstart My Heart"

AirPlay

• List devices: clawtunes airplay
• Select device: clawtunes airplay "Device Name"
• Deselect device: clawtunes airplay "Device Name" --off

Apple Music Catalog

• Search the streaming catalog: clawtunes catalog search "Bowie Heroes"
• Limit catalog results: clawtunes catalog search "Bowie Heroes" -n 5
• Note: Catalog search is browse-only. To add songs to playlists, they must first be in your library. Use Apple Music app to add catalog items to your library before managing them with clawtunes.

Notes

• macOS-only (uses AppleScript to communicate with Apple Music).
• If automation permissions are requested, grant access in System Settings > Privacy & Security > Automation.