ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add midudev/better-claude
/plugin install narrator@better-claude
Open the repo

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

The opening of the Narrator README: the narrator on switch at the bottom right of the prompt, and how it reads while it speaks.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • session.endWhen a session ends
  • command.runWhen you run its slash command/narrator/recap
  • prompt.submitWhen you send a prompt
  • turn.startWhen Claude starts a turn
  • tool.callAround a tool call, where it can hold one
  • turn.completeWhen a turn ends
  • ui.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
Repo
midudev/better-claude
Folder
plugins/narrator
Version
0.7.0
License
MIT
Repo stars
194
Last change
2026-10-22
Language
TypeScript
Files
10

Other mods in Workflow

cc10xromiluz13For cc10x, which writes every workflow to disk, draws the phase, running agent, and next step above the prompt, and a pane of the whole step chain.engineerswingermanHolds a commandFor DAE, a spec- and test-driven methodology kit, draws a pipeline band and a /dae pane, and denies unconfirmed pushes and a frontier model on a loop.jevmem-paneAvinash-jetwaniFor jevmem, memory saved to JEVMEM.md, draws a side pane of what it recalled for your prompt, its guard's last call, and what it saved.vbwswt-labsHolds a commandFor VBW, which proves every requirement with a check, draws a Mission Control pane and a Comms strip, and denies risky commands during a run.project-sentinelArjun0014Holds a commandDraws a status bar above the prompt for long runs, with milestones, context, cache, and the 5-hour window, a Control Room panel, and asks before risky calls.cortexesXBlueSkyFor Cortexes, a vault of your recorded sessions, draws its session-start menu as a band above the prompt, and offers a hand-off once the context is 70% full.proof9frankbriaHolds a commandTurns a bug into a CodeFRAME requirement and checks the ledger before each git commit Claude makes, warning by default or denying in block mode.directorEvolvingAgentsLabsHolds a commandKeeps a team's way of working as linked statements Claude plans from, and draws a status line and a band to run a waiting plan or accept a lesson it learned.bigquery-agent-analytics-modGoogleCloudPlatformStreams each session's prompts, model requests, tool calls, and subagents as rows to your BigQuery table, and says above the prompt when they land.next-stepsbradtraversyAfter each turn, has Haiku suggest two or three next prompts above the prompt, as buttons on the desktop that draft one, or 1, 2, and 3 in the terminal.critical-decisionsMucidaHas Claude record each call it made that you never asked for, with the reason, in a band above the prompt, red or yellow, with ok, rethink, and not critical.painelGabrielPauloTOpens a side panel, in Portuguese, of the running tool, Claude's latest thinking, its plan steps, the files it edited with line counts, subagents, and context.
All 396 in Workflow