Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
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 setupThat'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/codevatorWorks 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 categoryCustom 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 chillControl 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 packagesContributions are welcome! Please open an issue or submit a pull request.