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

uv tool install claude-listen      # or: pipx install claude-listen

Add your ElevenLabs API key (Text to Speech access is enough, 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)

listen --install

Then 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.0

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.0
File Size Uploaded Provenance Actions
claude_listen-0.1.0.tar.gz 33.9 kB With provenance Details for claude_listen-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 49.1 kB

Release files / claude_listen-0.1.0.tar.gz

Download URL claude_listen-0.1.0.tar.gz
Size 33.9 kB
Tags Source
SHA-256 checksum
How to use checksums
630257dd8fa790d2becc93e7db9f1656039de49a0ea9a3773836e5fac839f809
BLAKE2b-256 checksum
How to use checksums
ddd7d3f37e6b0a331f96cdc3bf8ca8e9c9639c1a30ca731f8aa57a40ba2ac22e
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.0-py3-none-any.whl

Download URL claude_listen-0.1.0-py3-none-any.whl
Size 15.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2e6a298a77d593bb12558c8ee7e9e3fd2fdaf7c871c61d864076d22ee102b8ab
BLAKE2b-256 checksum
How to use checksums
7c402671cd6211306c0633ce8e0f8d778e7a1e2220c4b1d6a96c591b8379c56f
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.0

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.0.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