{"_id":"@agentmag/sounds","_rev":"4-67e5980db136cc0b41b56990ff4f7e88","name":"@agentmag/sounds","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@agentmag/sounds","version":"1.0.0","keywords":["claude-code","claude-sounds","claude-code-sounds","claude-code-plugin","claude-plugin","claude-code-audio","claude-code-hooks","claude-code-notifications","sounds","sound-effects","terminal-sounds","coding-sounds","ai-agent-sounds","ai-coding","notification-sounds","developer-experience","developer-tools","dx","agentmag","agent-mag","cli-sounds","coding-audio","ambient-coding","terminal-audio","anthropic","ai-tools"],"author":{"url":"https://theagentmag.com","name":"Agent Mag","email":"hello@theagentmag.com"},"license":"MIT","_id":"@agentmag/sounds@1.0.0","maintainers":[{"name":"harshith.com","email":"hi@harshith.com"}],"homepage":"https://theagentmag.com/tools/agent-sounds","bugs":{"url":"https://github.com/Agent-mag/agent-sounds/issues"},"bin":{"agent-sounds":"scripts/agent-sounds.sh"},"dist":{"shasum":"6b0a06d5cea96cce2479cad0f311208eefa878f7","tarball":"https://registry.npmjs.org/@agentmag/sounds/-/sounds-1.0.0.tgz","fileCount":53,"integrity":"sha512-N2HQyn/Gvz2ctSc81YYMlzEABbjnPUf808TfIUUhhoxlKJe23blli6lPd1hFHPRa78ogInT2imHtAKGlXrXsUw==","signatures":[{"sig":"MEUCIEHQWNGik6udl/Q/zZBzRGbUlJwp24sS5l4ScafsoosuAiEAqjS0H6PFg5RbAgVuALTeSXE4ryQ1I6suCczYCCjeIBo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1148506},"gitHead":"c7fa3b2baf05fd39639f7e0d3bac6ecabd676c43","scripts":{"postinstall":"bash scripts/postinstall.sh || true"},"_npmUser":{"name":"harshith.com","email":"hi@harshith.com"},"repository":{"url":"git+https://github.com/Agent-mag/agent-sounds.git","type":"git"},"_npmVersion":"11.6.2","description":"Sound effects for Claude Code sessions — hear audio cues when tasks start, complete, or need attention. The best Claude Code sounds plugin with 4 original sound packs.","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sounds_1.0.0_1776947410966_0.204609686689734","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@agentmag/sounds","version":"1.0.1","keywords":["claude-code","claude-sounds","claude-code-sounds","claude-code-plugin","claude-plugin","claude-code-audio","claude-code-hooks","claude-code-notifications","sounds","sound-effects","terminal-sounds","coding-sounds","ai-agent-sounds","ai-coding","notification-sounds","developer-experience","developer-tools","dx","agentmag","agent-mag","cli-sounds","coding-audio","ambient-coding","terminal-audio","anthropic","ai-tools"],"author":{"url":"https://theagentmag.com","name":"Agent Mag","email":"hello@theagentmag.com"},"license":"MIT","_id":"@agentmag/sounds@1.0.1","maintainers":[{"name":"harshith.com","email":"hi@harshith.com"}],"homepage":"https://theagentmag.com/tools/agent-sounds","bugs":{"url":"https://github.com/Agent-mag/agent-sounds/issues"},"bin":{"agent-sounds":"scripts/agent-sounds.sh"},"dist":{"shasum":"9e0862e396d2c8e3b921deb6547b4cdbb4b5d516","tarball":"https://registry.npmjs.org/@agentmag/sounds/-/sounds-1.0.1.tgz","fileCount":53,"integrity":"sha512-Q+gKeveqSUQ5qI07o64ZVpj6EOfUXbK7bnG80WTMLW6a/+j/VJauIvpgLEyFNeLPwPsHM98dxIhlTVUZWz18JQ==","signatures":[{"sig":"MEQCIBO+UnO4cV+D7NKo3ppDV3U+Z+K2+0ZMy3S6tvD2BWThAiA5Z38w+arRRWAG8mSM4fW9nO1V/QINI1Wr2SREzNgXLQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1150019},"gitHead":"9a35082893dbe435cd02c0a8d8f78e98633eec29","scripts":{"postinstall":"bash scripts/postinstall.sh || true"},"_npmUser":{"name":"harshith.com","email":"hi@harshith.com"},"repository":{"url":"git+https://github.com/Agent-mag/agent-sounds.git","type":"git"},"_npmVersion":"11.6.2","description":"Sound effects for Claude Code sessions — hear audio cues when tasks start, complete, or need attention. The best Claude Code sounds plugin with 4 original sound packs.","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sounds_1.0.1_1776948741521_0.7366057572016842","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@agentmag/sounds","version":"1.0.2","keywords":["claude-code","claude-sounds","claude-code-sounds","claude-code-plugin","claude-plugin","claude-code-audio","claude-code-hooks","claude-code-notifications","sounds","sound-effects","terminal-sounds","coding-sounds","ai-agent-sounds","ai-coding","notification-sounds","developer-experience","developer-tools","dx","agentmag","agent-mag","cli-sounds","coding-audio","ambient-coding","terminal-audio","anthropic","ai-tools"],"author":{"url":"https://theagentmag.com","name":"Agent Mag","email":"hello@theagentmag.com"},"license":"MIT","_id":"@agentmag/sounds@1.0.2","maintainers":[{"name":"harshith.com","email":"hi@harshith.com"}],"homepage":"https://theagentmag.com/tools/agent-sounds","bugs":{"url":"https://github.com/Agent-mag/agent-sounds/issues"},"bin":{"agent-sounds":"scripts/agent-sounds.sh"},"dist":{"shasum":"d851b84f5cf4998ae4b9643ba73d561fb27f3a10","tarball":"https://registry.npmjs.org/@agentmag/sounds/-/sounds-1.0.2.tgz","fileCount":53,"integrity":"sha512-taRfNJfOJemdHHCZTnWpbbkm4xAYWvqpRE45dOSErbQDXSaLPLFvyR/2Tk5uAwS18SYbDTJS77ViDHwxAFNlGw==","signatures":[{"sig":"MEUCIQCQG5eD6jBWXZlvbMPYEoRmJZMDcNDxP229B5HPhYvLwAIgWf1IeL0svXUYCHbMXOOWpnq6YmOMwEZScBo/r+0cgNI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1150041},"gitHead":"66d77b3ec343db7015421e13f6b20e339f102e33","scripts":{"postinstall":"bash scripts/postinstall.sh || true"},"_npmUser":{"name":"harshith.com","email":"hi@harshith.com"},"repository":{"url":"git+https://github.com/Agent-mag/agent-sounds.git","type":"git"},"_npmVersion":"11.6.2","description":"Sound effects for Claude Code sessions — hear audio cues when tasks start, complete, or need attention. The best Claude Code sounds plugin with 4 original sound packs.","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sounds_1.0.2_1776952364759_0.20667956751266092","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@agentmag/sounds","version":"1.0.3","description":"Sound effects for Claude Code sessions — hear audio cues when tasks start, complete, or need attention. The best Claude Code sounds plugin with 4 original sound packs.","scripts":{"postinstall":"bash scripts/postinstall.sh || true"},"bin":{"agent-sounds":"scripts/agent-sounds.sh"},"keywords":["claude-code","claude-sounds","claude-code-sounds","claude-code-plugin","claude-plugin","claude-code-audio","claude-code-hooks","claude-code-notifications","sounds","sound-effects","terminal-sounds","coding-sounds","ai-agent-sounds","ai-coding","notification-sounds","developer-experience","developer-tools","dx","agentmag","agent-mag","cli-sounds","coding-audio","ambient-coding","terminal-audio","anthropic","ai-tools"],"homepage":"https://theagentmag.com/tools/agent-sounds","repository":{"type":"git","url":"git+https://github.com/Agent-mag/agent-sounds.git"},"bugs":{"url":"https://github.com/Agent-mag/agent-sounds/issues"},"author":{"name":"Agent Mag","email":"hello@theagentmag.com","url":"https://theagentmag.com"},"license":"MIT","_id":"@agentmag/sounds@1.0.3","gitHead":"5b7e7f3a3e0815fc60bcbf13cc8a0af445278fb1","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-o1k2LwYMMGswd52Zssw/JcqKDvLtt3+baq8xUGfmY1QqCmOW4Y6K/nvJhucY+HraqeoouWyqsN2BkGpc2u5ALQ==","shasum":"aff3c63ebe209ce4c03b379c0ad5bd580e24dd3f","tarball":"https://registry.npmjs.org/@agentmag/sounds/-/sounds-1.0.3.tgz","fileCount":53,"unpackedSize":1150041,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD1iSDTZUmP215qU8PRhnq00wMpyD7PRNx5Tx5viRGlSgIhAJsElcV7XICk+YjNVuX4K/Kfpr+IgpCKPWYafjgdKRRC"}]},"_npmUser":{"name":"harshith.com","email":"hi@harshith.com"},"directories":{},"maintainers":[{"name":"harshith.com","email":"hi@harshith.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sounds_1.0.3_1776957245238_0.8493055496108763"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-23T12:30:10.894Z","modified":"2026-04-23T15:14:05.545Z","1.0.0":"2026-04-23T12:30:11.245Z","1.0.1":"2026-04-23T12:52:21.771Z","1.0.2":"2026-04-23T13:52:44.970Z","1.0.3":"2026-04-23T15:14:05.404Z"},"bugs":{"url":"https://github.com/Agent-mag/agent-sounds/issues"},"author":{"name":"Agent Mag","email":"hello@theagentmag.com","url":"https://theagentmag.com"},"license":"MIT","homepage":"https://theagentmag.com/tools/agent-sounds","keywords":["claude-code","claude-sounds","claude-code-sounds","claude-code-plugin","claude-plugin","claude-code-audio","claude-code-hooks","claude-code-notifications","sounds","sound-effects","terminal-sounds","coding-sounds","ai-agent-sounds","ai-coding","notification-sounds","developer-experience","developer-tools","dx","agentmag","agent-mag","cli-sounds","coding-audio","ambient-coding","terminal-audio","anthropic","ai-tools"],"repository":{"type":"git","url":"git+https://github.com/Agent-mag/agent-sounds.git"},"description":"Sound effects for Claude Code sessions — hear audio cues when tasks start, complete, or need attention. The best Claude Code sounds plugin with 4 original sound packs.","maintainers":[{"name":"harshith.com","email":"hi@harshith.com"}],"readme":"
\n\n\"Agent\n\n# Agent Sounds\n\n**Sound effects for Claude Code sessions — hear audio cues when tasks start, complete, or need attention.**\n\n[![npm version](https://img.shields.io/npm/v/@agentmag/sounds?style=for-the-badge&color=000)](https://www.npmjs.com/package/@agentmag/sounds)\n[![npm downloads](https://img.shields.io/npm/dw/@agentmag/sounds?style=for-the-badge&color=000)](https://www.npmjs.com/package/@agentmag/sounds)\n[![License: MIT](https://img.shields.io/badge/License-MIT-000?style=for-the-badge)](LICENSE)\n[![Agent Mag](https://img.shields.io/badge/by-Agent_Mag-000?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAyTDIgMjJoMjBMMTIgMnoiLz48L3N2Zz4=)](https://theagentmag.com)\n\n[Browse Tools](https://theagentmag.com/tools)  ·  [npm](https://www.npmjs.com/package/@agentmag/sounds)  ·  [Website](https://theagentmag.com)\n\n
\n\n---\n\n## What It Does\n\nAgent Sounds hooks into Claude Code's lifecycle events and plays audio cues so you know what's happening without watching the terminal.\n\n4 original sound packs. 38 royalty-free sounds. Zero copyrighted audio. Works on macOS, Linux, and Windows.\n\n| Event | When It Fires | Sound |\n|-------|--------------|-------|\n| **Session Start** | You open Claude Code | Boot / greeting chime |\n| **Prompt Submit** | You send a message | Acknowledgment blip |\n| **Subagent Start** | A subagent spawns | Work sound |\n| **Plan Mode** | Enter / exit plan mode | Work / done |\n| **Task Complete** | Claude finishes responding | Success tone |\n| **Permission Request** | Claude needs your approval | Alert / attention |\n\nAll sounds play in the background — they never block Claude Code.\n\n---\n\n## Quick Start\n\n### Option A: One command (via agentmag CLI)\n\n```bash\nnpx agentmag add tool claude-sounds\n```\n\n### Option B: npm global install\n\n```bash\nnpm install -g @agentmag/sounds\n```\n\n### Option C: Claude Code plugin marketplace\n\n```bash\nclaude plugin install sounds@Agent-mag\n```\n\n---\n\n## Sound Packs\n\n| Pack | Vibe | Sounds |\n|------|------|--------|\n| **terminal-hacker** | Sci-fi hacking — boot sequences, data streams, digital alerts | 10 |\n| **retro-synth** | 80s synthwave — warm pads, arpeggios, analog warmth | 10 |\n| **minimal-tones** | Clean beeps and chimes — subtle, professional, non-distracting | 9 |\n| **nature-ambient** | Forest and water — wind chimes, water drops, bird chirps | 9 |\n\nAll packs are enabled by default. Mix and match to your preference.\n\nAll sounds are generated via Python waveform synthesis (sine waves, square waves, envelope shaping) — no copyrighted game audio, no licensing issues.\n\n---\n\n## CLI Commands\n\n```bash\nagent-sounds status # Show current config\nagent-sounds packs # List available sound packs\nagent-sounds enable # Enable a sound pack\nagent-sounds disable # Disable a sound pack\nagent-sounds volume 0.5 # Set volume (0.0 to 1.0)\nagent-sounds mute # Mute all sounds\nagent-sounds unmute # Unmute all sounds\nagent-sounds test # Play all event sounds\nagent-sounds test ready # Play a specific event\nagent-sounds reset # Reset config to defaults\n```\n\n---\n\n## Configuration\n\nConfig is stored in `config.json` in the package root:\n\n```json\n{\n \"enabled\": [\"terminal-hacker\", \"retro-synth\", \"minimal-tones\", \"nature-ambient\"],\n \"volume\": 0.25,\n \"muted\": false\n}\n```\n\n---\n\n## Create Custom Sound Packs\n\n1. Create a directory under `sounds/` with your pack name\n2. Add audio files (`.wav` or `.mp3`)\n3. Create a `source.json` mapping events to files:\n\n```json\n{\n \"ready\": [\"my-start-sound.wav\"],\n \"work\": [\"working-01.wav\", \"working-02.wav\"],\n \"done\": [\"complete.wav\"],\n \"ask\": [\"attention.wav\"]\n}\n```\n\n4. Enable it: `agent-sounds enable my-pack`\n\n---\n\n## How Claude Code Sounds Work\n\nClaude Code supports [hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) — shell commands that execute on lifecycle events. Agent Sounds registers hooks for 7 events that trigger `play.sh`, which:\n\n1. Reads your config (enabled packs, volume, muted state)\n2. Collects matching audio files from all enabled packs\n3. Picks one at random\n4. Plays it in the background via your OS audio player\n\nThe entire plugin is bash scripts + audio files. No Node.js runtime, no heavy dependencies.\n\n## Requirements\n\n- **Python 3** — for JSON parsing in shell scripts\n- **Audio player** — auto-detected per platform:\n\n| Platform | Player |\n|----------|--------|\n| macOS | `afplay` (built-in) |\n| Linux | `pw-play` → `paplay` → `ffplay` |\n| Windows | `ffplay` → PowerShell MediaPlayer |\n\n---\n\n## Comparison\n\n| Feature | Agent Sounds | claude-sounds |\n|---------|-------------|---------------|\n| Sound packs | 4 original (royalty-free) | 4 (copyrighted game audio) |\n| Custom packs | Yes | Yes |\n| Cross-platform | macOS, Linux, Windows | macOS, Linux, Windows |\n| CLI management | Full CLI with neon UI | Full CLI |\n| Copyrighted audio | No — all original | Yes (Warcraft, Dota 2, Red Alert 2) |\n| Install via agentmag | `npx agentmag add tool claude-sounds` | No |\n| License | MIT (code + audio) | MIT (code) / Non-commercial (audio) |\n\n---\n\n## Inputs\n\n| Config Key | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `enabled` | `string[]` | All 4 packs | Which sound packs are active |\n| `volume` | `number` | `0.25` | Playback volume (0.0 — 1.0) |\n| `muted` | `boolean` | `false` | Whether sounds are muted |\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE) for details. All sound files are original, royalty-free waveform synthesis.\n\n---\n\n
\n\n**Built by [Agent Mag](https://theagentmag.com)** — the magazine for AI agent builders.\n\n[Website](https://theagentmag.com)  ·  [Tools](https://theagentmag.com/tools)  ·  [Skills](https://theagentmag.com/skills)  ·  [Newsletter](https://theagentmag.com/newsletter)  ·  [GitHub](https://github.com/Agent-mag)\n\n
\n","readmeFilename":"README.md"}