Skip to content
Back to search

chanmeng-audio-hooks

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chanmeng666--echook/badge.svg)](/listings/chanmeng666--echook)

HTML

<a href="/listings/chanmeng666--echook"><img src="/api/listings/chanmeng666--echook/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 29 lines
  1. {
  2. "name": "chanmeng-audio-hooks",
  3. "owner": {
  4. "name": "Chan Meng",
  5. "url": "https://github.com/ChanMeng666"
  6. },
  7. "metadata": {
  8. "description": "Audio notifications for Claude Code, Cursor IDE & Codex CLI, configured in natural language. 39 hook events across Claude Code, Cursor and Codex (30 registered on Claude Code) + 47 matcher variants, each with its own sound. Desktop toasts, TTS, webhook fan-out, a status line that follows the subagent you are viewing, per-subagent rows, rate-limit alerts. Auto-bridges to Cursor 3.2.16+; native install for Cursor-only via 'audio-hooks install --cursor'; native install for Codex via 'audio-hooks install --codex'.",
  9. "version": "7.2.4"
  10. },
  11. "plugins": [
  12. {
  13. "name": "audio-hooks",
  14. "source": "./plugins/audio-hooks",
  15. "version": "7.2.4",
  16. "description": "Audio notifications + AI-controlled config for Claude Code, Cursor IDE, and Codex CLI events. Auto-bridges to Cursor 3.2.16+; native install for Cursor via 'audio-hooks install --cursor' and for Codex via 'audio-hooks install --codex'.",
  17. "author": {
  18. "name": "Chan Meng",
  19. "url": "https://github.com/ChanMeng666"
  20. },
  21. "homepage": "https://github.com/ChanMeng666/echook",
  22. "repository": "https://github.com/ChanMeng666/echook",
  23. "license": "MIT",
  24. "category": "productivity",
  25. "tags": ["audio", "notifications", "tts", "webhook", "status-line", "cursor", "codex"],
  26. "keywords": ["audio", "notifications", "hooks", "tts", "webhook", "ai-operated", "rate-limits", "status-line", "cursor", "cursor-ide", "codex", "codex-cli", "openai-codex"]
  27. }
  28. ]
  29. }
README.md · README · 80 lines
  1. <div align="center">
  2. <img src="./public/echook-logo.svg" width="112" alt="echook">
  3. # echook
  4. ### Know when your agent needs you.
  5. A sound, a desktop toast or a message on your phone when Claude Code, Cursor or Codex finishes, asks for permission or hits a rate limit.
  6. <a href="docs/INSTALLATION_GUIDE.md"><img src="./.github/readme/pill-install-guide.svg" height="40" alt="Install guide"></a> <a href="plugins/audio-hooks/skills/audio-hooks/SKILL.md"><img src="./.github/readme/pill-talk-to-it.svg" height="40" alt="Talk to it"></a> <a href="docs/STATUS_LINE.md"><img src="./.github/readme/pill-status-line.svg" height="40" alt="Status line"></a> <a href="CHANGELOG.md"><img src="./.github/readme/pill-changelog.svg" height="40" alt="Changelog"></a>
  7. </div>
  8. <br>
  9. <a href="#try-it"><img src="./.github/readme/card.svg" width="100%" alt="echook is an open-source notification system for the AI coding agents Claude Code, Cursor and Codex. The card shows a terminal session recreated in code from the product's own output: a permission request reaches you as a sound, a desktop toast and a phone notification, a subagent is opened and the status line follows it from Sonnet 5.5 to Haiku 5.5 and from 76K/200K to 29K/~1M of context, and a setting is changed by asking the agent (“mute audio for an hour”)."></a>
  10. <br>
  11. https://github.com/user-attachments/assets/eb723799-6e06-42d6-8855-addcdf74888f
  12. <sub>Every frame is code: a replica of echook's terminal UI in Remotion, with a synthesised score. How it was made: <a href="https://github.com/ChanMeng666/film-echook-terminal">film-echook-terminal</a>.</sub>
  13. <details>
  14. <summary><sub>The first film (89 s)</sub></summary>
  15. https://github.com/user-attachments/assets/804dff1e-56d8-49b2-b0c0-6706f3eeccd4
  16. <sub>Made with Remotion, Claude Code, ElevenLabs and Suno. How it was made: <a href="https://github.com/ChanMeng666/echook-promo-video">echook-promo-video</a>.</sub>
  17. </details>
  18. ## Try it
  19. Say this to your agent in Claude Code, Cursor or Codex:
  20. > *Install echook from `github.com/ChanMeng666/echook` and set it up for me.*
  21. It reads the docs, runs every command and checks the result. Two steps stay with you: type `/reload-plugins` once in Claude Code, or restart the editor once on the Cursor and Codex install paths.
  22. Or add the `audio-hooks` skill first with the skills CLI ([skills.sh](https://skills.sh/chanmeng666)), then say the same sentence:
  23. ```bash
  24. npx skills add ChanMeng666/echook
  25. ```
  26. After that, every setting is a sentence:
  27. > *Mute audio for an hour.* · *Switch to chimes.* · *Put a context-usage bar in my status line.*
  28. ## Why echook
  29. - **You choose what you hear.** 39 hook events, each with its own sound. Three are on by default.
  30. - **Settings are sentences.** Your agent runs one `audio-hooks` command for each. There is no config file to edit by hand.
  31. - **It reaches you away from the screen.** A sound at your desk, a desktop toast, a spoken summary, or a webhook to Slack, Discord, Teams or ntfy.
  32. - **The status line shows the agent you are watching.** Open a subagent in Claude Code and the line switches to that agent's model, effort and context. Claude Code alone keeps showing the main agent's.
  33. <img src="./.github/readme/feature-viewed-agent.svg" width="100%" alt="The echook status line follows the agent in view: opening the Explore subagent changes the line from [Sonnet 5.5] to [▸ Haiku 5.5], with that agent's own effort and context. Task shown: find how retries are configured.">
  34. ```mermaid
  35. flowchart LR
  36. E[Editor event] --> R[hook_runner.py]
  37. R --> C{Snoozed, debounced<br/>or filtered out?}
  38. C -->|no| O([Sound · toast · speech · webhook])
  39. ```
  40. It runs on your machine, on Windows, macOS and Linux. No telemetry: data leaves your computer only if you set a webhook, and then only to the URL you chose.
  41. ## For your agent
  42. This page is all a person needs. Everything else is written for agents: clone the repo and point yours at [`AGENTS.md`](AGENTS.md) or [`llms.txt`](llms.txt). Once echook is installed, one command returns its live state:
  43. ```bash
  44. audio-hooks manifest
  45. ```
  46. <sub>[Install guide](docs/INSTALLATION_GUIDE.md) · [Troubleshooting](docs/TROUBLESHOOTING.md) · [Changelog](CHANGELOG.md) · [Privacy](PRIVACY.md) · [Contributing](CONTRIBUTING.md) · [MIT](LICENSE)</sub>
  47. <sub>Built by [Chan Meng](https://github.com/ChanMeng666).</sub>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.