codevator
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 49 GitHub stars
Code Basarisiz
- fs.rmSync — Destructive file system operation in packages/cli/src/__tests__/agents.test.ts
- process.env — Environment variable access in packages/cli/src/__tests__/agents.test.ts
- fs.rmSync — Destructive file system operation in packages/cli/src/__tests__/config.test.ts
- process.env — Environment variable access in packages/cli/src/__tests__/config.test.ts
- fs.rmSync — Destructive file system operation in packages/cli/src/__tests__/doctor.test.ts
- process.env — Environment variable access in packages/cli/src/__tests__/doctor.test.ts
- fs.rmSync — Destructive file system operation in packages/cli/src/__tests__/import.test.ts
- process.env — Environment variable access in packages/cli/src/__tests__/import.test.ts
- fs.rmSync — Destructive file system operation in packages/cli/src/__tests__/player-daemon.test.ts
- process.env — Environment variable access in packages/cli/src/__tests__/player-daemon.test.ts
- fs.rmSync — Destructive file system operation in packages/cli/src/__tests__/player.test.ts
- process.env — Environment variable access in packages/cli/src/__tests__/player.test.ts
- fs.rmSync — Destructive file system operation in packages/cli/src/__tests__/profile.test.ts
- process.env — Environment variable access in packages/cli/src/__tests__/profile.test.ts
Permissions Gecti
- Permissions — No dangerous permissions requested
This tool plays background music while AI coding agents (like Claude Code, Codex, or Cursor) are actively working, automatically pausing the audio whenever the agent needs user attention.
Security Assessment
Overall risk: Low. The tool does not request dangerous permissions and contains no hardcoded secrets. All flagged findings—`fs.rmSync` and `process.env` access—appear strictly within test files (`__tests__/`), which is standard practice for creating isolated test environments and reading test configurations. No issues were found in the core application code. The tool requires local file access to import custom audio files and manage agent hooks, which is expected for its functionality. Spotify integration likely requires standard network requests and OAuth, but this is initiated by the user.
Quality Assessment
The project is in excellent health. It is actively maintained (last pushed today), uses a permissive MIT license, and provides clear documentation. With 49 GitHub stars, it has a solid foundation of community trust for a niche utility. The codebase is well-structured, using a standard TypeScript monorepo setup with dedicated packages for the CLI.
Verdict
Safe to use — it is a well-maintained, harmless utility with all security flags safely isolated to standard testing practices.
Background sounds that play while Claude Code works and stop when it needs your attention — so the silence doesn't drive you to a “that's what she said” moment.
codevator
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

Quick Start
npx codevator setup
That's it. Next time Claude Code starts working, you'll hear elevator music. 🎵
Other agents?
npx codevator setup --agent <name>
Supported agents: claude (default), codex, gemini, copilot, cursor, windsurf, opencode
Agent Skill
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.
Sounds
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
Commands
| 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 |
Profiles
Save your favorite setups as presets:
npx codevator profile save chill --mode lofi-relax --volume 40
npx codevator profile load chill
macOS Menu Bar
Control codevator from your menu bar — no terminal needed:
npx codevator install-menubar
Packages
| Package | Description |
|---|---|
packages/cli |
CLI tool — npm |
packages/web |
Website — codevator.dev |
Development
pnpm install
pnpm dev:web # Next.js dev server
pnpm dev:cli # CLI watch mode
pnpm build # Build all packages
Contributing
Contributions are welcome! Please open an issue or submit a pull request.
License
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi