Skillget

codevator

agent
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 49 GitHub stars
Code Fail
  • 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 Pass
  • Permissions — No dangerous permissions requested
Purpose

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.
SUMMARY

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.

README.md

codevator

npm version
License: MIT

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

Codevator

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

MIT

Reviews (0)

No results found