Narrator
Hear what Claude Code did after each turn
What this mod can do
- Reviewed at commit a2babd9
- Runs programs
- Sends its own requests to Claude, which uses your tokens
- Reads environment variables
- Sees each prompt you send and can change or drop it
- Sees each tool call before it runs and can block or change it
- Also uses $.audio.speak, which this page doesn't describe yet
4 more things it can do
- Remembers data between sessions
- Adds the /narrator command
- Adds the /recap command
- Runs on a timer
Good to know (3)
- Each narrated turn makes a Haiku call, which uses your tokens.
- Voices: Siri's on macOS, Narrator's on Windows, speech-dispatcher or espeak on Linux.
- It stays on in later sessions until you switch it off.
Preview
Terminal
⎿ narrator: Narrator on: Claude will tell you out loud what it did after each turn.
⏵ narrator onClaude Desktop
What it does
Turn it on with /narrator or the switch in the footer, and after each turn Claude tells you out loud what it did, in your language, with your system's best free voice.
- What you see
- A narrator switch in the footer
- Works in
- Terminal and Claude Desktop
- Slash commands
- /narrator, /recap
- Uses your tokens
- Yes
- Changes files
- Only through programs it runs
- Network access
- Only through programs it runs
- Reviewed commit
- a2babd9
- Preview recorded with
- Claude Code 2.1.296
How it works
- A switch at the bottom right of the prompt reads narrator on or narrator off.
- When a turn ends, Haiku writes one or two spoken sentences about what Claude did.
- A short answer is read out as it is, with no Haiku call.
- Your system's voice speaks it; a new prompt cuts the narration short.
Common questions
How can I hear what Claude Code did after each turn?
Turn on Narrator with /narrator or its switch in the footer. After each turn Claude says out loud what it did in one or two short sentences, using Siri's voices on macOS, Narrator's on Windows and speech-dispatcher on Linux.