echook

echook

Know when your agent needs you.

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.

https://github.com/user-attachments/assets/eb723799-6e06-42d6-8855-addcdf74888f

Every frame is code: a replica of echook's terminal UI in Remotion, with a synthesised score. How it was made: film-echook-terminal.

The first film (89 s)

https://github.com/user-attachments/assets/804dff1e-56d8-49b2-b0c0-6706f3eeccd4

Made with Remotion, Claude Code, ElevenLabs and Suno. How it was made: echook-promo-video.

Try it

Say this to your agent in Claude Code, Cursor or Codex:
*Install echook from github.com/ChanMeng666/echook and set it up for me.*

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.

After that, every setting is a sentence:
*Mute audio for an hour.* · *Switch to chimes.* · *Put a context-usage bar in my status line.*

Why echook

- You choose what you hear. 39 hook events, each with its own sound. Three are on by default.
- Settings are sentences. Your agent runs one audio-hooks command for each. There is no config file to edit by hand.
- 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.
- 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.

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.

For your…