Skip to main content

claude-listen

Listen to your latest Claude Code reply instead of reading it. Each word is highlighted in the terminal as it is spoken.

  • Reads the last reply of the Claude Code session you are in, even with many sessions open
  • ElevenLabs voices (default model eleven_v4), with per-character timestamps for exact highlighting
  • Generates paragraph by paragraph, so audio starts in about a second
  • Code blocks are shown, not read: playback pauses 5 seconds so you can look at them
  • Optional free, offline voice with Kokoro (--local)
  • macOS (uses afplay)

Install

As a Claude Code plugin (easiest)

Needs uv and iTerm2.

/plugin marketplace add sunggatalimbetov/claude-listen
/plugin install listen-aloud@listen-aloud

Then type /listen in any session.

As a CLI

uv tool install claude-listen      # or: pipx install claude-listen
listen --install                   # adds /listen to Claude Code

API key

Create an ElevenLabs key with Text to Speech access (plus Voices read for --voices):

mkdir -p ~/.config/speak
echo "ELEVENLABS_API_KEY=sk_..." > ~/.config/speak/env
chmod 600 ~/.config/speak/env

Or export ELEVENLABS_API_KEY.

Use

listen                 # read the latest reply (Claude pane in this iTerm tab)
! listen               # typed inside Claude Code: opens a pane reading this session
listen notes.md        # read a file
pbpaste | listen       # read the clipboard
listen --voices        # list voices
listen --set-voice George
listen --local         # Kokoro, offline

Keys: space pause, ←/→ previous/next paragraph, +/- speed, q quit.

/listen in Claude Code (iTerm2)

Type /listen in any Claude Code session. A pane opens below, reads that session's last reply and closes when it finishes. ! listen does the same without a model turn.

Which session is read

  1. --session <id> if given
  2. Inside Claude Code (/listen or ! listen): that session, via CLAUDE_CODE_SESSION_ID
  3. In iTerm: the Claude pane in the current tab (matched by tty through ~/.claude/sessions)
  4. Otherwise: the session that replied most recently

Local voice (Kokoro)

uv tool install "claude-listen[local]"

Put kokoro-v1.0.onnx and voices-v1.0.bin from the kokoro-onnx releases in ~/.cache/speak/kokoro/. Highlighting with Kokoro is estimated, not exact.

Config

Env var Default
ELEVENLABS_API_KEY read from ~/.config/speak/env
SPEAK_MODEL eleven_v4
SPEAK_CONFIG ~/.config/speak/config.json

Audio is cached in ~/.cache/speak, so replaying a reply costs no credits.

License

MIT

Metadata

Release files for claude-listen 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for claude-listen 0.1.1
File Size Uploaded Provenance Actions
claude_listen-0.1.1.tar.gz 34.4 kB With provenance Details for claude_listen-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for claude-listen 0.1.1
File Interpreter ABI Platform Actions
claude_listen-0.1.1-py3-none-any.whl Python 3 none any Details for claude_listen-0.1.1-py3-none-any.whl

Total release size: 49.9 kB

Release files / claude_listen-0.1.1.tar.gz

Download URL claude_listen-0.1.1.tar.gz
Size 34.4 kB
Tags Source
SHA-256 checksum
How to use checksums
6a41422b93de9f7df0d91386c10f7ebb0558e2158a7a2df4e8d257f29391762d
BLAKE2b-256 checksum
How to use checksums
46a1beae72af850b6c8dbbc93f40df47f174430e6245e6795eb08cf1d2fba810
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Release files / claude_listen-0.1.1-py3-none-any.whl

Download URL claude_listen-0.1.1-py3-none-any.whl
Size 15.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c39c69661cb05fef6dd89afd0da3a78cd9322142740a49a4ffdb45a1ffe59a6e
BLAKE2b-256 checksum
How to use checksums
c50b092785239b0981822274fc597a1757b1cb97f7de8f5df7775d12a3e638e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Security for claude-listen 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for claude_listen-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page