All shelves / Mods / Workflow
narrator
By midudev
narrator is a Claude Code workflow mod by midudev.
Speaks a one or two sentence recap after each turn, in your language, with your system's best free voice, switched from the footer or /narrator.
Draws
Install
The marketplace name is better-claude.
/plugin marketplace add midudev/better-claude /plugin install narrator@better-claude
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.7.0
- License
- MIT
- Repo stars
- 194
- Last change
- 2026-10-22
What it can reach
- Draws in the session
- Sees tool calls
- Calls another program on this machine
The switch sits at the bottom right of the prompt, ⏵ narrator on in green or ⏸︎ narrator off in gray. A click switches it in fullscreen, and /narrator works anywhere. While it speaks the switch reads ⏹︎ narrating, and a click stops it. When a turn ends, Haiku, at low effort, reads your request, the tools Claude used, and its final message, and writes one or two short spoken sentences in first person, ending with Claude's question when it asked you one, in the language you wrote in or the one you set. A short answer is read out as it is, with no Haiku call. The voice is AVSpeechSynthesizer on macOS, Siri's natural voices first, Windows.Media.SpeechSynthesis on Windows, Windows' voices through powershell.exe under WSL, and spd-say, espeak-ng, or espeak on Linux. A new prompt cuts the narration short. It stays on in your next sessions until you switch it off. A claude -p session is not narrated. /narrator stop, again, read, voices, and test are the other commands, and read reads Claude's last answer in full, even with the narrator off. The settings in /config are Voice, Language, Speed, 1.3 by default, Read short answers as they are, 200 characters by default, the model, haiku by default, and Speak command, a program of your own on macOS and Linux that gets the narration as its last argument. Several windows share one line, so their narrations are said one after the other.
The marketplace name is better-claude. The marketplace also holds after, use-haiku, think-hard, token-meter, sub-meter, context-meter, image-preview, commit, and time-machine. This one installs on its own. The spoken recap of each turn is why this page files it under workflow. sportscaster speaks play-by-play of the session, with crowd noise, and opens a booth pane. vox draws a waveform above the prompt while vox speaks. This one says what Claude did after each turn, and reads the last answer in full when you ask. Haiku is a model call on the login Claude Code already holds.
Demo

What it hooks into
session.startWhen a session startssession.endWhen a session endscommand.runWhen you run its slash command/narrator/recapprompt.submitWhen you send a promptturn.startWhen Claude starts a turntool.callAround a tool call, where it can hold oneturn.completeWhen a turn endsui.renderDraws into the sessionSessionModePromptHint
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/narratorClaude tells you out loud what it did after each turn · no argument: switch on or off
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- midudev
- Category
- Workflow
- Marketplace
- better-claude
- Folder
- plugins/narrator
- Version
- 0.7.0
- License
- MIT
- Repo stars
- 194
- Last change
- 2026-10-22
- Language
- TypeScript
- Files
- 10