Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>Read Aloud: Claude Code Response (Terminal)New to Visual Studio Code? Get it now.
Read Aloud: Claude Code Response (Terminal)

Read Aloud: Claude Code Response (Terminal)

Vinayak Sharma

| (0) | Free
Read Claude Code's latest terminal response aloud, with pause and stop controls.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

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.

Platforms (system voice / fallback)

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.
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft