In the trenches of agentic development, context switching is the enemy. A new plugin called orc-work-notify, posted to Hacker News by user vagkaratzas, attempts to solve the 'when is my agent done?' problem by injecting personality into the feedback loop. The tool hooks into Claude Code events and plays specific sound effects from a public domain Orc Voice Pack, signaling three distinct states: prompt submission, agent attention requests, and task completion. It is a small utility, but it speaks to a growing trend in the AI-native dev stack: making asynchronous agent loops feel more synchronous and human.

The Mechanics Of The Orc

The plugin operates on a simple three-tier event system. When a user sends a prompt, the UserPromptSubmit hook triggers submit.wav. If Claude requires human interventionβ€”such as answering a question or granting permission via AskUserQuestion or Notificationβ€”the PreToolUse hook plays attention.wav. Finally, when the agent completes its cycle, the Stop hook fires stop.wav. These sounds play in the background, ensuring zero latency impact on the model's inference speed. The author credits John Carroll for the CC0-licensed audio assets, which are sourced from his free Orc Voice Pack. The plugin maps yes1.wav to the submit event, yescommand.wav to the attention event, and satisfied1.wav to the stop event.

Customization And Control

For developers who prefer a different auditory signature, the plugin supports a robust 'bring your own orc' feature. Users can drop custom .wav files into ~/.claude/sounds/ for global overrides or /.claude/sounds/ for project-specific configurations. The system prioritizes the most specific location, and folder-based randomization is supported for variety. Muting is handled via a simple flag file at ~/.claude/orc-work-notify.muted, while audio playback intelligently falls back through a chain of system players including afplay, pw-play, paplay, ffplay, aplay, and powershell.exe to ensure compatibility across macOS, Linux, and Windows environments.

Key Takeaways

  • The plugin uses non-blocking background audio to prevent performance degradation during agent execution.
  • Custom sound support allows for granular control over both global and project-specific alert tones.
  • Audio assets are CC0 licensed, avoiding copyright issues common with proprietary sound packs.
  • Installation is streamlined via the Claude plugin marketplace with a single CLI command.

The Bottom Line

While it might seem like a gimmick, orc-work-notify addresses a real UX friction point in agentic coding. If it keeps you from doom-scrolling while your agent refactors a module, it has already earned its place in the stack.

Hacker News Reception

The project has recently appeared on Hacker News, highlighting the community's interest in lightweight, personality-driven developer tools. The repository is MIT licensed, and the code is minimal, making it an easy candidate for forking or integration into existing dotfiles. Keep an eye on the discussion for potential feature requests, such as distinct sounds for error states versus successful completions.