codevator CLI
Background music for a coding agent: it plays while the agent works and stops when it waits for your input.
- 65 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Setup writes hooks into the agent configuration and starts a background playback process.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/codevatorDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Setup writes hooks into the agent configuration and starts a background playback process.
This is third-party code. Review the repository files before installing.
What it does
codevator installs hooks into an agent that start a sound when a task begins and stop it when the agent halts. It offers 15 built-in sounds: elevator music by default, lofi, rain, forest, ocean, retro, piano and more. There is a Spotify mode, import of your own audio files and a random sound for each session. The `mode`, `volume`, `on`, `off`, `list`, `preview`, `stats`, `doctor` and `profile` commands control sound from the terminal. A separate skill gives the agent the same commands, and macOS users can add a menu bar app.
Who it is for. Developers who leave an agent running in the background and want to hear whether it is busy or waiting for a decision.
Good fit when
- An agent writes code for a long time and the sound shows when it stopped.
- Different sounds are needed per session: rain for long tasks, lofi for reviews.
- Sound settings are saved as a profile and moved to another machine with `import`.
- The agent is asked to change sound or volume with a plain phrase through the skill.
Not a fit when
- You work in silence or in a shared office without headphones.
- You need text notifications instead of background sound.
- The agent runs on a server without a sound card.
Example request
Set up codevator for Claude Code and switch to the lofi-chill mode at volume 40.Limitations
Setup changes the chosen agent's configuration because hooks are written into its settings. Spotify mode needs your own Spotify account, and sound comes from it. Built-in tracks ship in the package and work offline. Your own files are added with `add` and kept locally. The menu bar app works on macOS only. Supported agents are `claude`, `codex`, `gemini`, `copilot`, `cursor`, `windsurf` and `opencode`.
How to disable. Turn sound off with `npx codevator off` and remove the hooks from the agent settings. The skill is removed by deleting its folder.
FAQ
How do I connect codevator to Cursor or Codex?
Run `npx codevator setup --agent cursor` or `--agent codex`. Without the flag setup targets Claude Code.
Can I add my own music?
Yes, `npx codevator add my-vibe ~/Music/chill-loop.mp3` imports the file as a separate sound.
How do I pick a random sound?
`npx codevator mode --random` picks a sound for each session, and `--category nature` limits the choice to a category.
What does the doctor command do?
It diagnoses the setup by checking that hooks are in place and sound starts.
Which sound is the default?
Elevator music, `elevator`. The other sounds are grouped into focus and ambient, nature, music and retro.
Discussion
No questions or reviews yet.
Related
CLI toolsHook-driven sounds for coding agents: starts, failures, completions and even individual Bash commands each get their own cue
echook plays a sound, a desktop toast or a message when Claude Code, Cursor or Codex finishes or waits for your permission
Sound and on-screen notifications for coding agents: game voice lines when the agent finishes or waits for permission
Local voice layer for Claude Code and Codex on macOS: when the agent finishes or fails, it says in a sentence or two what happened
A realtime voice layer on top of Claude Code, Codex and OpenCode that keeps talking and listening while background tasks run in parallel
Agent Standup shows Claude Code, Codex and Mistral Vibe sessions as a live team call: who works, who waits.
Comparison with similar tools
Cards that share the main search query, and how they differ.
README in short
The repository holds the CLI, a website and an agent skill. Quick start is one command that installs hooks, and the rest is tuned with `mode`, `volume` and `profile`.