Background music for your AI coding agent.
Agent starts working → music plays. Agent stops → music stops. Simple as that.
Website · Docs · Sounds Gallery · npm · Issues
npx codevator setup
That's it. Next time Claude Code starts working, you'll hear elevator music. 🎵
npx codevator setup --agent <name>
Supported agents: claude (default), codex, gemini, copilot, cursor, windsurf, opencode
Install the codevator skill so any AI agent can control your music directly:
npx skills add educlopez/codevator
Works across Claude Code, Cursor, Windsurf, Gemini CLI, and more. The agent gets the ability to switch sounds, adjust volume, and toggle playback — hands-free.
15 built-in sounds in 3 categories, plus Spotify integration:
| Category | Sounds |
|---|---|
| Focus & Ambient | elevator (default), typewriter, minimal, lofi-relax, lofi-chill, lofi-cozy |
| Nature | ambient, rain, forest, ocean |
| Music & Retro | retro, classical-piano, ambient-guitar, epic-strings |
| Integration | spotify — plays from your Spotify account |
npx codevator mode lofi-chill npx codevator mode --random # random sound each session npx codevator mode --category nature # random from a category
Custom sounds — import your own audio files:
npx codevator add my-vibe ~/Music/chill-loop.mp3| Command | What it does |
|---|---|
setup |
Install hooks for your agent |
mode <name> |
Set the sound mode |
on / off |
Enable or disable sounds |
volume <n> |
Set volume (0–100) |
list |
Show all available sounds |
add <name> <file> |
Import a custom sound |
preview <name> |
Preview a sound without installing |
stats |
Show your listening stats |
doctor |
Diagnose issues with your setup |
profile <name> |
Save/load mode + volume presets |
import <file> |
Import settings from a file |
install-menubar |
Install the macOS menu bar app |
Save your favorite setups as presets:
npx codevator profile save chill --mode lofi-relax --volume 40 npx codevator profile load chill
Control codevator from your menu bar — no terminal needed:
npx codevator install-menubar
| Package | Description |
|---|---|
packages/cli |
CLI tool — npm |
packages/web |
Website — codevator.dev |
pnpm install pnpm dev:web # Next.js dev server pnpm dev:cli # CLI watch mode pnpm build # Build all packages
Contributions are welcome! Please open an issue or submit a pull request.