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.

listen demo

▶ Watch the demo with sound

  • 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 (plays through AVFoundation, so the highlight follows the exact audio position)

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

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.2
File Size Uploaded Provenance Actions
claude_listen-0.1.2.tar.gz 3.0 MB With provenance Details for claude_listen-0.1.2.tar.gz

Built distribution (wheel)

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

Total release size: 3.0 MB

Release files / claude_listen-0.1.2.tar.gz

Download URL claude_listen-0.1.2.tar.gz
Size 3.0 MB
Tags Source
SHA-256 checksum
How to use checksums
878681a802203dc2c019b1ac67f35682d0d23671c268c2321e87e7842d4b2aef
BLAKE2b-256 checksum
How to use checksums
b7d35adf0e4f9815eb06c4057dc57ed42feb725ce479b2ec23be5ce85481d8b5
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.2-py3-none-any.whl

Download URL claude_listen-0.1.2-py3-none-any.whl
Size 15.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
16a27cb7c73583acf21404731687808fcbb956039200b65a3b3d7791c2672d78
BLAKE2b-256 checksum
How to use checksums
363cf5300cee82ab2b92c8149c8d1622775a8318a210dd657aace752969d6c40
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.2

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