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.

echook_60s_landscape_1920x1080.mp4

_{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)}

promo-video.mp4

_{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.

flowchart LR
    E[Editor event] --> R[hook_runner.py]
    R --> C{Snoozed, debounced<br/>or filtered out?}
    C -->|no| O([Sound · toast · speech · webhook])

Loading

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 agent

This page is all a person needs. Everything else is written for agents: clone the repo and point yours at AGENTS.md or llms.txt. Once echook is installed, one command returns its live state:

audio-hooks manifest

_{Install guide · Troubleshooting · Changelog · Privacy · Contributing · MIT}

_{Built by Chan Meng.}