What is voice-claude?

Voice-claude is a Python wrapper for Claude Code, a terminal-based AI coding assistant, that lets you give instructions by speaking instead of typing. Hold a key, say what you want, release the key, and your words are automatically transcribed and submitted to Claude as if you had typed them yourself. The tool listens for the Right Option key on your keyboard. While held, it records your voice. On release, it uses Apple's Speech Recognition framework to convert the audio to text and types it into Claude. Transcription happens on your device, and no audio is sent to any external service. The tool also tells Claude that input came from speech recognition, so Claude knows to ask for clarification when a transcription sounds unclear rather than acting on a garbled command. Spoken numbers like one, two, three are converted into digits, useful for selecting options in Claude's menu prompts. The README describes this as a prototype and strongly warns against running Claude with full permissions. Transcription errors can cause Claude to receive incorrect instructions, potentially leading to deleted files, force-pushed branches, or unintended commits. Using the most restrictive permission mode available is recommended so destructive actions still require manual approval. The tool runs on macOS only and relies on Apple's Speech Recognition framework and system sounds. It requires Homebrew, Python 3.10 or newer, and Claude Code already installed. Your terminal application needs microphone, accessibility, and speech recognition permissions granted in macOS system settings before it will work. Because it types directly into whatever application has focus, voice-claude is not limited to Claude Code in principle, but the README frames it specifically as a companion for that tool and tests it in that context.