ChanMeng666/echook

66 stars · Last commit 2026-05-05

🔊 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/>
26 hook events, 2 audio themes, rate-limit alerts, webhooks, TTS, context monitor — all operated by your AI agent on your behalf.<br/>
**🆕 5.2.x — echook rebrand + native Codex CLI.** Renamed from `claude-code-audio-hooks` → **echook** (Echo + Hook, /ˈɛkˌhʊk/) in 5.2.1: now that native install paths ship for **Claude Code, Cursor IDE, and Codex CLI**, leading with "Claude Code" in the name was misleading. **Door-only rename, zero migration:** the `audio-hooks` CLI, the `chanmeng-audio-hooks` marketplace name, and all state directories are unchanged — existing installs keep working via GitHub URL redirect. **5.2.0** added the Codex CLI path itself: `audio-hooks install --codex` writes `~/.codex/hooks.json` registering all 6 events Codex supports (per [developers.openai.com/codex/hooks](https://developers.openai.com/codex/hooks)). AI-first feature-flag handling — install authors a fresh `~/.codex/config.toml` when none exists, emits machine-readable `next_steps` for the calling AI agent when one needs editing. New `--invoker codex` CLI flag, new `editor_targets.codex` block in status, new `codex: {...}` sub-object in webhook payloads, +33 bridge-contract tests. See [CHANGELOG](./CHANGELOG.md#521---2026-05-05). All 5.1.x fixes still active.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Version](https://img.shields.io/badge/version-5.2.1-blue.svg)](https://github.com/ChanMeng666/echook)
[![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)](#pick-your-platform)
[![Install](https://img.shields.io/badge/install-just_talk_to_your_AI_agent-purple.svg)](#pick-your-platform)

**Share This Project**

[![][share-x-shield]][share-x-link]

View full repository on GitHub →