Claude Code Plugin

claude-narrator

Hear and see what Claude Code is doing — in real time.

claude-narrator

                            $ claude
                        
                            🚀 Claude session started. Let's go.
                        
                            🔊 About to read package.json
                        
                            ✅ Done reading package.json
                        
                            🔊 About to edit index.ts
                        
                            ✅ Edited index.ts
                        
                            🔊 About to run command: npm test
                        
                            ✅ Command finished
                        
                            🏁 Task complete, awaiting your input

Install

Plugin marketplace

/plugin marketplace add nerdynikhil/claude-narrator

/plugin install claude-narrator@nerdynikhil-claude-narrator

Or clone manually

git clone https://github.com/nerdynikhil/claude-narrator.git && cd claude-narrator && ./install.sh

Four hooks, full coverage

🚀

SessionStart

Announces startup, resume, clear, and compact events

🔊

PreToolUse

Context-aware tool announcements — filenames, commands, search patterns

✅

PostToolUse

Confirms what just happened after each tool finishes

🏁

Stop

Notifies when Claude is done and waiting for your next prompt

Features

✓ Text-to-speech via say (macOS) or espeak (Linux)
✓ Configurable voice with NARRATOR_VOICE env var
✓ Disable TTS with NARRATOR_TTS=0 — emoji output stays
✓ Optional timestamped logging to file
✓ All output to stderr — never interferes with Claude
✓ TTS runs in background — never blocks tool execution
✓ Graceful fallback when no TTS engine is available
✓ Clean uninstall with ./install.sh --uninstall

View on GitHub