Engineering

Why I gave my coding assistant a local voice


The result is claude-voice, a public local voice tool with synchronized word highlighting.

Voice input made it easier to talk through a coding problem, but the answer still pulled my attention back to the terminal. I wanted to hear longer explanations while continuing to inspect code.

The constraints were the product

The solution had to run locally, start automatically, stop immediately when interrupted, and avoid reading code-heavy output aloud. Those constraints mattered more than adding a large voice feature set.

Highlighting made audio easier to trust

Speech alone can be difficult to scan or resume. Synchronized word highlighting keeps the visual and audio positions connected, especially when a response includes unfamiliar technical terms.

Small distribution won

The project stayed intentionally compact. A developer should be able to understand what it changes, install it quickly, and remove it without leaving a platform behind. That narrowness is a major reason people used it.

The lesson I kept: do not build a new platform when one missing behavior inside an existing workflow is the actual problem.

Open source on GitHub. The repository contains the implementation; this article stays focused on product decisions rather than reproducing it.