Isa1asN

Beckon — AI skill for Claude Code

AI community

Distinct sounds for your AI coding agent: know whether it finished, needs a decision, or failed, without watching the terminal.

How to install Beckon

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Isa1asN/beckon and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Beckon does

Distinct sounds for your AI coding agent: know whether it finished, needs a decision, or failed, without watching the terminal.

Alternatives in AI

Anthropic Quickstarts — by Anthropic - Offers comprehensive development guides for three distinct AI-powered demo projects with standa 15.4k ★
Codex Plugin — 's /codex:adversarial-review command 9.6k ★
Oil UI — Push AI UI design to its limits: explore distinct directions, compare them side by side, and refine against re 861 ★

README

beckon

[![CI](https://github.com/Isa1asN/beckon/actions/workflows/ci.yml/badge.svg)](https://github.com/Isa1asN/beckon/actions/workflows/ci.yml) [![crates.io](https://img.shields.io/crates/v/beckon-cli.svg)](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