← sources

Walkthrough: a voice typing app made with Claude Code, from first prototype to version 1.8.3

source: reddit (reddit:ClaudeAI)published 2026-10-30 15:26ingested 2026-10-31 02:36

retained text

VoxScribe is a free, open source voice typing app for Windows and Android, made with Claude Code as the coding assistant. You hold a key in any program, talk, and the text is typed where your cursor is. Everything runs on your own PC, so nothing is uploaded. Version 1.8.3 just shipped with meeting notes, medical, legal and business word packs, and optional extra speech models. Here is what the Claude Code side of the project looked like, in case it helps anyone building something similar.

The [CLAUDE.md](http://CLAUDE.md) file in the repo records decisions that came from real failures, not just a description of the folders. For example, the audio code picks the Windows microphone driver and sample rate in a specific way because the obvious choice gave near-silent audio on a Bluetooth headset. Writing that reason down stopped it from being “simplified” later. When a rule has a reason attached, the assistant respects it.

The project has about 590 automated tests and a linter that run on every push. They cover the plain logic, such as the text cleanup, the number formats and the meeting note writer. They do not cover the microphone or the screen, so those still need a human to try them. Knowing which half the tests cover made it easier to tell when something was safe to ship.

One build went wrong in a way no test caught. The installer was packaged from a half-finished build and came out around 23 MB instead of over 300 MB, and it was installed before anyone noticed. The fix was a small script that refuses to install unless the build exits cleanly and both the folder and the installer are a sensible size. A check like that takes ten minutes to ask for and saves a lot of confusion.

Two smaller habits helped. Rebuilds of the installer take several minutes, so changes are batched and checked in a quick script first instead of rebuilding after every edit. And the project notes live in a plain markdown vault, so a new session can pick up where the last one stopped without anyone re-explaining it.

Even the launch video was made this way: a script drives the real app, takes frames of the real windows, and adds the captions and sound around them, so what you see is the app’s own output.

Source and installer: [github.com/ahmedhmam1994/voxscribe-ai-voice-dictation](http://github.com/ahmedhmam1994/voxscribe-ai-voice-dictation)

Happy to explain any part in more detail, and if you have a way you keep a Claude Code project from drifting, I would like to hear it.

document fetched 2026-10-31 00:22 · canonical https://reddit.com/r/ClaudeAI/comments/1xjie2a/walkthrough_a_voice_typing_app_made_with_claude