Documentation

Set up in 30 seconds

One command. Background music plays while your agent works, stops when it's done. No config needed.

Quick start

Install codevator via npx. It sets up hooks and downloads the default sound:

npx codevator

Done. Next time your agent starts working, elevator music plays. When it finishes or waits for input, the music stops. Fully automatic.

Multi-agent support

Codevator works with 7 coding agents. Pick yours during setup:

npx codevator setup --agent claude

All agents share the same sounds, config, and profiles. You can set up multiple agents on the same machine.

Agent skill

Want your agent to change music for you? Install the codevator skill:

npx skills add educlopez/codevator

Skills is an open registry for agent capabilities — learn more on GitHub.

Works across Claude Code, Cursor, Windsurf, Gemini CLI, and 30+ other agents. Once installed, just ask:

  • “Play some lo-fi while I review this PR”
  • “Switch to nature sounds”
  • “Turn the volume down to 30”
  • “Show me my listening stats”

Your agent runs the right codevator command behind the scenes.

Ready?

Exit the elevator.

Start building.