music

Managing a local music library from the terminal is often a disjointed experience involving manual downloads and scattered files. This skill provides a structured interface for the music CLI to handle audio retrieval, indexing, and background playback on macOS and Linux. It eliminates the friction of jumping between browser tabs and terminal windows by centralizing library management through a single agent interface.

What it does

• Audio Retrieval downloads permitted audio as 320 kbps MP3 files for local storage.
• Library Indexing maintains a SQLite database to track artists, titles, and file paths.
• Playback Control manages a background player process to start, stop, or check status.
• Smart Filtering searches existing local files before attempting new downloads to save bandwidth.
• Metadata Management organizes files in a structured ~/Music/Library/ hierarchy by artist and title.

How it works

1. Search and Query the agent to find specific tracks or list the current local library using filters.
2. Execute Commands via the CLI using subcommands like get, play, or list with the --json flag for parsing.
3. Verify State by inspecting JSON responses to confirm if files were cached or freshly downloaded.
4. Monitor Background Processes using the status command to track active player PIDs and metadata.

Frameworks & tools

This skill requires a pre-installed Python music runtime, SQLite for indexing, and standard terminal access on macOS or Linux systems.

Why this beats prompting it yourself

Writing raw CLI commands for audio retrieval often leads to messy file structures and zombie background processes. This skill enforces a strict JSON-based contract and structured directory schema, ensuring your library stays organized and your player state remains trackable.

Use cases

• Build a local high-quality MP3 library from permitted web sources.
• Control background audio playback without leaving your development environment.
• Audit a local music collection for specific artists or missing metadata.
• Automate the retrieval and playback of specific audio assets for testing.

Known limitations

No support for Windows, volume control, seeking, or playlists. Requires a pre-installed music runtime and does not bypass DRM or paywalls.