Read Aloud: Claude Code Response (Terminal)
Reads Claude Code's latest response aloud from VS Code or Cursor, with Pause/Resume and Stop. Everything is local: text never leaves your machine.
Usage
- Click Read in the status bar (bottom right), or run Read Aloud: Read Latest Claude Code Response, or press
Cmd/Ctrl+Alt+R.
- While speaking the status bar shows Pause and Stop (
Cmd/Ctrl+Alt+. also stops). Paused shows Resume.
- Reading again replaces whatever is playing.
How it works
Claude Code writes each session to ~/.claude/projects/<workspace-path>/<session>.jsonl. The extension finds the newest transcript for the open workspace, takes the assistant text after your last prompt (skipping tool calls, thinking, and sub-agents), converts markdown to plain speech (code blocks are skipped by default), and hands it to your OS speech engine in short chunks.
Natural voice (recommended)
The built-in OS voices sound robotic. The extension can install a local neural voice (Kokoro) that sounds far more natural:
- On first Read you're offered the install, or run Read Aloud: Set Up Natural Voice any time.
- One-time ~120 MB download into the extension's private storage; needs Python 3.10-3.13 on the machine. Runs fully offline afterwards; no text leaves your computer.
- Pick a voice with
readAloud.naturalVoice (default af_heart). If it ever fails, the system voice is used automatically (set readAloud.engine to natural to disable the fallback, or system to never use it).
- The first sentence takes ~1-4 s to start while the model warms up; later sentences are generated while the previous one plays.
| OS |
Engine |
Pause |
| macOS |
say (built in) |
instant (process suspend) |
| Windows |
PowerShell System.Speech (built in) |
replays the current sentence on resume |
| Linux |
espeak-ng/espeak (preferred), else spd-say |
instant with espeak; sentence replay with spd-say |
Linux: sudo apt install espeak-ng (or speech-dispatcher).
Settings
readAloud.engine (auto/natural/system), readAloud.naturalVoice, readAloud.voice (system voice), readAloud.rate (0.5-3), readAloud.readCodeBlocks, readAloud.maxChars, readAloud.transcriptDir (default ~/.claude/projects).
Install / develop
npm install
npm test # unit tests (includes real `say` tests on macOS)
npm run test:integration # VS Code host test (set VSCODE_EXECUTABLE to use a local VS Code)
npm run package # builds read-aloud-claude-code-<version>.vsix
code --install-extension read-aloud-claude-code-0.1.0.vsix # or: cursor --install-extension ...
Limitations
- The transcript format is not a public API; the parser is tolerant but may need updates if it changes.
- With several Claude Code sessions active in one workspace, the most recently written one is read.