chendrizzy/claude-tts

claude-tts is a plugin for Claude Code, the AI coding assistant from Anthropic, that reads out loud a filtered summary of what the agent is doing while it works. Instead of staying silent or printing walls of text, the tool converts key moments in the agent's activity into spoken audio you can hear without watching the screen. The core idea is selective speech. The tool listens to everything the agent does but speaks only four kinds of event: test results (like "23 passed, 4 failed"), error messages written to stderr, notable insights the agent flags, and the agent's final answer at the end of a task. Routine activity such as reading files, editing code, running git commands, or printing code blocks is ignored. A local AI model running on your own machine helps judge which moments are worth speaking and can summarize long passages before they are voiced. If you prefer not to run a local AI, the tool still works using deterministic rules alone. The text-to-speech step is handled by one of several supported engines, including a free cross-platform option called edge-tts, platform system voices on macOS and Linux, and a local neural voice model called Kokoro designed for Apple Silicon machines. The spoken output has markdown stripped out before synthesis, so you never hear punctuation symbols or formatting characters read aloud. Installation is through the Claude Code plugin marketplace. A setup command detects your operating system, picks an appropriate voice engine and AI backend, and installs a background service that starts automatically when you begin a coding session. A doctor command lets you re-check the setup at any time. The plugin requires Python 3.11 or newer and is released under the MIT license, which allows free use for any purpose.