audio-hooks

echook

AI-operated audio notification system for Claude Code, Cursor IDE, and Codex CLI.
You type one slash command at install time. Then natural language forever.
26 hook events, 2 audio themes, rate-limit alerts, webhooks, TTS, context monitor — all operated by your AI agent on your behalf.
🆕 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). 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. All 5.1.x fixes still active.

Share This Project

[![][share-x-shield]][share-x-link] [![][share-linkedin-shield]][share-linkedin-link] [![][share-reddit-shield]][share-reddit-link] [![][share-telegram-shield]][share-telegram-link] [![][share-whatsapp-shield]][share-whatsapp-link]

Promotional Video

https://github.com/user-attachments/assets/f57249be-a524-4e6f-8225-6b9500f1aea4

^{Built with Remotion, Claude Code, ElevenLabs & Suno. Source: echook-promo-video}