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-hooks CLI is the only interface. Every command is non-interactive and returns JSON with stable error codes. Never edit user_preferences.json by hand: use audio-hooks set <dotted.key> <value> and the typed setters (hooks enable, theme set, webhook set, tts set, rate-limits set).
  • Run audio-hooks manifest first 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 --schema gives the config JSON Schema.
  • Diagnose before guessing: audio-hooks status, then audio-hooks diagnose (its errors carry a code and a suggested_command to run), then audio-hooks logs tail --n 20. Verify a fix with audio-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 run audio-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_USAGE and change nothing; --help is always safe.

Installing (three entry points)

  • Claude Code (plugin, the recommended path): claude plugin marketplace add ChanMeng666/echook --json then claude plugin install audio-hooks@chanmeng-audio-hooks --json (audio-hooks install --plugin prints exactly these and changes nothing). Then ask the user to type /reload-plugins in 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/echook then codex plugin add audio-hooks@chanmeng-audio-hooks, or the native fallback audio-hooks install --codex; follow the next_steps / feature_flag_state in its output. Codex does not auto-bridge Claude Code plugins.
Installs
1
GitHub Stars
90
First Seen
10 days ago