ChanMeng666/echook

76 stars ยท Last commit 2026-07-07

๐Ÿ”Š echook โ€” AI-operated audio notifications for Claude Code, Cursor IDE & Codex CLI โ€” 26 hooks, voice + chime themes, TTS, webhooks, rate-limit alerts, status line. Tell your AI agent to install โ€” natural language forever after.

README preview

<div align="center"><a name="readme-top"></a>

[![Project Banner](./public/echook-logo.svg)](#)

# echook

**AI-operated audio notification system for Claude Code, Cursor IDE, and Codex CLI.**<br/>
You type one slash command at install time. Then natural language forever.<br/>
Hear when your agent finishes, needs permission, or hits a rate limit โ€” and pin a context-usage status line so you never lose your place.

<sub>**v6.2.0** โ€” 39 hook events across all three editors ยท 2 audio themes ยท webhooks ยท TTS ยท rate-limit alerts ยท status line. Renamed `claude-code-audio-hooks` โ†’ **echook** (Echo + Hook) in 5.2.1; existing installs keep working. Full history in the [CHANGELOG](./CHANGELOG.md).</sub>

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Latest Release](https://img.shields.io/github/v/release/ChanMeng666/echook?label=release&color=blue&sort=semver)](https://github.com/ChanMeng666/echook/releases/latest)
[![Release Date](https://img.shields.io/github/release-date/ChanMeng666/echook?label=released&color=blue)](https://github.com/ChanMeng666/echook/releases)
[![CI](https://img.shields.io/github/actions/workflow/status/ChanMeng666/echook/smoke.yml?branch=master&label=CI)](https://github.com/ChanMeng666/echook/actions/workflows/smoke.yml)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-green.svg)](https://github.com/ChanMeng666/echook)
[![Editors](https://img.shields.io/badge/editors-Claude_Code_%7C_Cursor_%7C_Codex-brightgreen.svg)](#get-started)
[![Install](https://img.shields.io/badge/install-just_talk_to_your_AI_agent-purple.svg)](#get-started)

View full repository on GitHub โ†’