
What it does
- Manage your music: index your library and repair metadata in place. Album artist, year, cover art, and genres, without moving your files.
- Build and move playlists: curate named collections, then push and pull them between your iPod, Plexamp, and Apple Music.
- Scrobble: send your iPod listens to Last.fm.
How to use it
- As a CLI: scan your library, curate playlists with an interactive picker, and sync them to a device or service from your terminal.
- As an MCP server: do all of it conversationally from Claude: “build a 45-minute late-night mix and put it on my iPod,” “what’s on my iPod?,” “push my road-trip playlist to Plexamp.”
Who it’s for
Anyone with a music library on a Mac and a classic iPod they still love. It’s single-tenant by design: your library and your iPod live on your machine, and clickwheel works with them in place.Quickstart
Install, index your library, and load your iPod in a few commands.
MCP server
Drive clickwheel from Claude, locally or from your phone.
CLI reference
Every command and flag (generated from the source).
Architecture
How the pieces fit, and why it’s Mac-as-source-of-truth.

