Beckon

beckon

[](https://github.com/Isa1asN/beckon/actions/workflows/ci.yml) [](https://crates.io/crates/beckon-cli)

Distinct sounds for your AI coding agent, so you don't have to watch the terminal.

beckon binds to your agent's lifecycle hooks and plays a different sound depending on what it needs:

Sound	Meaning	What to do
rising chime	finished its turn	go look
insistent sting	blocked on your decision	go unblock it
falling tone	it failed	go read the error
slow pulse	rate-limited or throttled	wait

A single undifferentiated ding tells you something happened. It doesn't tell you whether to get up.

Install

cargo install beckon-cli   # the binary is called `beckon`
beckon init                # binds the hooks — shows a diff and asks first
beckon test                # hear the active pack

Or from source: `git clone https://github.com/Isa1asN/beckon && cd beckon && cargo install --path .`

`init` prints the exact change it will make to `~/.claude/settings.json`, copies the file to `settings.json.beckon-backup-` beside itself, and only then writes. `beckon uninstall` removes beckon's entries and leaves everything else alone.

It refuses to touch a settings file it cannot round-trip: invalid JSON, invalid UTF-8, a non-object root, or an unfamiliar `hooks` shape. A file it does accept is re-serialised, so non-canonical formatting (CRLF, tabs, duplicate keys) is normalised. Content is preserved; the backup keeps the original bytes.

Platform support

	Builds	Test suite	Audio verified
Linux x86-64	yes	yes	yes
macOS	yes	in CI	no
Windows	yes	in CI	no

CI runs the full suite on all three. CI runners have no sound device, so playback there goes through the null backend — the macOS and Windows audio paths com