File of the day

A Claude Code hook that tells you by sound whose move is next

Slava Sazhin 29 September 2026 3 min read

A Claude Code Stop hook ends a reply with a short tone: a ringing one when the work is done, a lower one when your decision or action is needed.

Today's file is a Claude Code hook for people who give Claude a task and go to another window. Then you either come back every few minutes to see whether it has finished, or Claude waits half an hour for a yes it asked for in its last line. The hook ends the reply with a short tone, and the tone tells you which of the two it is: the work is done, or Claude needs you.

How it works

Before its last message Claude writes one word into the signal file of its session, /tmp/claude_signal_<session id>. done means the work is closed and nothing is needed from you: a ringing tone. need means your move: a decision, access, something to do by hand or a look at the result: a lower tone. When the reply ends, the Stop hook reads the word, plays the tone and deletes the file. No file or an empty file means silence. An unknown word counts as need: an extra call costs less than a missed one.

A tone and not a voice, because the neighbours hear a voice too and a tone carries exactly one meaning. The hook never blocks Claude: the sound is its only action.

What to change

Quiet hours: from 20:00 to 9:00 by the computer clock the hook stays silent, and the note below sets your own, for example 22 to 8. The two sounds are made from the macOS system sounds Glass and Purr and played with afplay. If your computer is not a Mac, the note asks Claude to replace afplay with the player of your system.

Install

One file goes into ~/.claude/hooks/ and is connected in ~/.claude/settings.json as a Stop hook. The note below then has Claude make the two sounds, check that jq is installed, add a rule to ~/.claude/CLAUDE.md to write the word as its last action, and allow two things without confirmation: writing the signal file and the command echo $CLAUDE_CODE_SESSION_ID that gives Claude its session number. Without the second permission Claude Code stops for your confirmation of that command at the end of every reply, because the command contains a $. Then restart Claude Code. The check: ask Claude to write need and you hear the low tone after its reply, then the same with done and the ringing one.

The files

sound-signal.sh 3 KB
how-to-install.md 2 KB

Files of the day are for paying subscribers: any plan opens every one. Already subscribed? Then sign in.

See the plans

Was this article worth your time?

Read next

Give Claude a computer of its own

Your own Linux machine with Claude Code on it, working around the clock while your laptop is shut. From $3.49 a month.

Contact the Combobulating team