audio-hooks
Installation
SKILL.md
audio-hooks skill
This plugin is the AI control surface for the echook project. The user does NOT operate it by hand. You operate it for them through the audio-hooks binary, which this plugin adds to your Bash tool's PATH.
Rules
- The
audio-hooksCLI is the only interface. Every command is non-interactive and returns JSON with stable error codes. Never edituser_preferences.jsonby hand: useaudio-hooks set <dotted.key> <value>and the typed setters (hooks enable,theme set,webhook set,tts set,rate-limits set). - Run
audio-hooks manifestfirst for anything you do not immediately recognise (subcommands, hooks, config keys, error codes, env vars). It never lags the running version; this file can.audio-hooks manifest --schemagives the config JSON Schema. - Diagnose before guessing:
audio-hooks status, thenaudio-hooks diagnose(its errors carry acodeand asuggested_commandto run), thenaudio-hooks logs tail --n 20. Verify a fix withaudio-hooks test all. - Do not ask the user to confirm ("[y/N]"). If they gave an instruction, run it.
- Do not translate JSON output. Keys and values are stable contracts.
- Reporting commands are read-only (
status,diagnose,get,hooks list,snooze status,manifest,statusline segments, every--help, ...). A stale preferences file (PREFS_SCHEMA_STALE) is not fixed by running them; the next hook event or any state-changing command migrates it, or runaudio-hooks migrate(v6.7, no flags, idempotent). - No subcommand acts on an argument it does not understand. State-changing subcommands answer an unknown flag or stray positional with
INVALID_USAGEand change nothing;--helpis always safe.
Installing (three entry points)
- Claude Code (plugin, the recommended path):
claude plugin marketplace add ChanMeng666/echook --jsonthenclaude plugin install audio-hooks@chanmeng-audio-hooks --json(audio-hooks install --pluginprints exactly these and changes nothing). Then ask the user to type/reload-pluginsin any already-open session. It is REPL-only; never fake it via Bash. - Cursor:
audio-hooks install --cursor(see the duplicate-bridge section below). - Codex: plugin path
codex plugin marketplace add ChanMeng666/echookthencodex plugin add audio-hooks@chanmeng-audio-hooks, or the native fallbackaudio-hooks install --codex; follow thenext_steps/feature_flag_statein its output. Codex does not auto-bridge Claude Code plugins.