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 1 view
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
Files of the day are for paying subscribers: any plan opens every one. Already subscribed? Then sign in.
See the plansWas this article worth your time?
Read next
File of the day
A Claude Code command that picks the new features of the week for you
Once a week a Claude Code command reads what is new in Claude Code, checks it against how you work and keeps only the advice that fits, with a ready request.
File of the day
A Claude Code subagent that reads your text as the person it is for
A Claude Code subagent reads a letter, post or offer as the person it is addressed to before it goes out and splits its remarks into blocking and optional.
File of the day
A Claude Code command that sifts your notes into a knowledge base every night
A Claude Code command reads the notes of the last day at night and adds to your knowledge base what will still matter in three months. It deletes nothing.
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.