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

Genre	Vibe	Great for	Stations
lofi	Chill downtempo beats, mellow vibes	Focused coding, debugging, writing tests	3
jazz	Smooth jazz, bossa nova, instrumental	Building features, refactoring	4
classical	Orchestral, chamber music, deep focus	Code review, reading, research	3
ambient	Atmospheric drones, space music	Brainstorming, design, creative work	6
electronic	Electronic, trance, IDM, dubstep, trip-hop	Shipping sprints, high-energy sessions	6
synthwave	Retro-futuristic, 80s-inspired	Late night coding, nostalgic vibes	3
lounge	Cinematic, spy-movie elegance	Demos, presentations, smooth backdrop	2
indie	Indie pop, folk, dream pop	Creative writing, docs, warm sessions	4

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

Works Everywhere

Platform	How it plays
macOS	mpv or ffplay (via Homebrew) or built-in afplay
Linux	mpv or ffplay (via apt, dnf, pacman, etc.)
WSL2	mpv/ffplay inside WSL (with WSLg audio) or Windows-side mpv.exe
Windows	mpv (via winget, scoop, or chocolatey)

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

All Commands