vclaw

Voice control for Claude Code. Speak commands, vclaw types them into Claude Code running in tmux, and speaks the results back.

Install

curl -fsSL https://raw.githubusercontent.com/MadHouseLabs/vclaw/master/install.sh | sh

Requires tmux and Claude Code.

Usage

vclaw              # Start in current directory
vclaw attach       # Reattach to existing session
vclaw auth         # Authenticate with Anthropic

Key bindings

Key	Action
F12	Push-to-talk / interrupt
Alt-M	Toggle mute

Build from source

brew install cmake              # macOS
# sudo apt install cmake libasound2-dev   # Linux

cargo install --path .

The OAuth client ID is injected at compile time via ANTHROPIC_OAUTH_CLIENT_ID env var. Release binaries get it from a GitHub Actions secret.

Architecture

See docs/architecture.md.

License

MIT