SkillFoxx

echook plugin

echook plays a sound, a desktop toast or a message when Claude Code, Cursor or Codex finishes or waits for your permission

  • 90 ★ on the repository
  • Last commit
  • MIT
Plugin

Extended access

Why this level

  • Installs hooks into Claude Code, Cursor and Codex, runs scripts on every agent event and plays sound
  • Webhooks send event text to external services at addresses you specify
All reasons and checks

chanmeng666/echookAuthor:Chan Meng

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add plugins/echook

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Installs hooks into Claude Code, Cursor and Codex, runs scripts on every agent event and plays sound
  • Webhooks send event text to external services at addresses you specify

This is third-party code. Review the repository files before installing.

What it does

The plugin catches agent hook events and turns them into a sound, a desktop toast, a spoken summary or a webhook to Slack, Discord, Teams and ntfy. There are 39 events, each with its own sound and three on by default. Sound themes include voices and chimes, with text-to-speech and rate-limit alerts. Settings change by sentence: mute audio for an hour, switch to chimes, and the agent runs an `audio-hooks` command. No hand-edited config file is needed. The status line in Claude Code follows the subagent you are viewing: when you open a subagent it shows that agent's model, effort and context. It runs on Windows, macOS and Linux, has no telemetry and data leaves only to the webhook you set. `audio-hooks manifest` returns the live plugin state.

Who it is for. Developers who start long tasks in Claude Code, Cursor or Codex and step away from the screen but must hear a permission request or the end of the work.

Good fit when

  • The agent often asks for permission while you are busy elsewhere and you need to hear it
  • A long build finished and the notification should reach your phone through ntfy or Slack
  • You want a spoken summary of the agent reply to save you reading the terminal
  • You need the active subagent's model and context in the status line

Not a fit when

  • You need sounds in another agent tool: the plugin covers Claude Code, Cursor and Codex
  • The environment has no sound and no way to install hooks
  • You need a full cost monitoring dashboard: the plugin notifies and does not track tokens per project

Example request

Install echook from github.com/ChanMeng666/echook and set it up: chimes in place of voice and a phone notification through ntfy

Limitations

  • In Claude Code run `/reload-plugins` once after install, and in Cursor and Codex restart the editor once.
  • Of the 39 events 30 are registered on Claude Code and the rest belong to Cursor and Codex, and on Cursor 3.2.16 and newer the bridge is automatic.
  • The status line follows the viewed subagent in Claude Code only, where without this plugin it keeps showing the main agent's context.
  • Webhooks send event text to addresses you choose, so use trusted ones.

How to disable. Ask the agent to uninstall echook or run `/plugin uninstall` for the plugin in Claude Code. Hooks and sounds in `audio/custom` live in the plugin folder and go with it.

FAQ

How do I install echook?

Ask the agent to install echook from ChanMeng666/echook, or add the skill with `npx skills add ChanMeng666/echook` and repeat the request. Then run `/reload-plugins` once in Claude Code.

How do I change settings?

With a sentence to the agent such as mute audio for an hour or put a context-usage bar in the status line. The agent runs the matching `audio-hooks` command.

Where does data go?

Nowhere except the webhook you set. There is no telemetry and the plugin runs on your machine.

Which notification channels exist?

A sound at your desk, a desktop toast, a spoken summary and webhooks to Slack, Discord, Teams and ntfy.

What does the status line show?

The model, effort and context of the agent you opened, main or subagent. Without the plugin Claude Code shows the main agent's data.

Discussion

No questions or reviews yet.

Plugins

Hook-driven sounds for coding agents: starts, failures, completions and even individual Bash commands each get their own cue

CLIExtended access121

Agent Notifications is an alert plugin that includes project and branch context in Claude Code and Codex desktop messages.

PluginExtended access831

Sound and on-screen notifications for coding agents: game voice lines when the agent finishes or waits for permission

CLIExtended access5.1K

Code-Notify sends a desktop notification when Claude Code, Codex or Gemini CLI finishes a task or waits for your input

CLIExtended access291

Local voice layer for Claude Code and Codex on macOS: when the agent finishes or fails, it says in a sentence or two what happened

CLIExtended access217

A macOS CLI that installs hooks for Claude Code, Codex and Copilot CLI: a push arrives when work ends or approval is needed.

CLIExtended access58

README in short

The README describes echook as a notification system for Claude Code, Cursor and Codex. It gives a sample install request, settings-by-sentence examples, a flow from a hook event to a sound or webhook and a note on the status line. Three-platform support and no telemetry are stated separately, and the rest lives in the guides.

README badge

Report a problem