claude-music

Music in your Claude Code Sessions

Enjoy great music and vibes while Claude Code does the heavy lifting. Lofi, jazz, classical, ambient, and more — streaming live from the internet, right in your coding session.

No setup, no sign ups, no accounts. Just install the plugin and start listening.

Quick Start

/play                # Start playing (lofi genre by default)
/play jazz           # Play a specific genre or station name
/next                # Skip to a different station (same genre)
/prev                # Go back to the previous station
/stop                # Stop the music
/volume up           # Nudge volume up (or down, or set 0-100)
/mute                # Mute without stopping the stream
/shuffle             # Random genre, random station — surprise me
/status              # See what's playing right now

Or let the resident AI DJ Ken pick for you:

/vibe                            # DJ reads your session and picks automatically
/mood feeling tired, need energy  # Tell the DJ your mood in your own words

Or start a focus session with a timer:

/focus              # 25 min pomodoro — music fades out and chimes when done
/focus 45 ambient   # 45 min with ambient music

See the full command list for more.

Installation

Claude Code (via Plugin Marketplace)

Register the marketplace first:

/plugin marketplace add kennethleungty/claude-music-marketplace

Then install the plugin:

/plugin install claude-music@claude-music-marketplace

Verify Installation

Start a new session and try /play or /vibe.

Don't have an audio player installed? No worries — the plugin detects this and walks you through installing one automatically.

AI DJ

The plugin includes a resident AI DJ (DJ Ken) that picks the right music for you. Debugging? He switches to lofi. Deep in a code review? Classical kicks in. He learns your preferences over time — the more you use it, the better he gets.

• /vibe — DJ Ken reads your current session and picks automatically. No input needed.
• /mood <feeling> — Tell him what you want in your own words: "calm me down", "something retro and fun".
• /prefs — See what he's learned about your taste over time.

Genres

Each genre has multiple stations. Use /next to cycle through them.

Works Everywhere

The plugin auto-detects your platform and available audio players. If nothing is installed, it offers to set one up for you.

All Commands

/focus              # 25 min, current genre
/focus 45 ambient   # 45 min of ambient

Contributing

Know a great stream that belongs here? We'd love your help growing the station library. Musicians, DJs, radio nerds, and anyone with good taste — open an issue or PR with your recommendation. Include the stream URL, a short description, and which genre it fits best.

All streams should be free, ad-free, and publicly accessible.

For Music Producers & Composers

Make music that's perfect for coding? We're always looking for new streams to feature.

This plugin plays background music during Claude Code sessions. If you produce lofi, ambient, jazz, electronic, or anything that pairs well with deep focus, your music could reach developers while they're actually in flow.

To get featured, open an issue with:

• A link to your stream (YouTube livestream, Icecast/Shoutcast URL, etc.)
• A short description of your sound
• Which genre category fits best (or suggest a new one)

We'll listen, and if it's a good fit, add it to the station library for everyone.

Coming Soon

Spotify Integration — Connect your Spotify account and play your own playlists directly through the plugin.