Talk to your coding agents. Keep every word on your Mac.
Realtime, fully local dictation for the menu bar. Press a key and speak. Your words appear while you're still talking.
Install · Documentation · Coding agents · Contributing
demo.mp4
Unlike tools that transcribe after you stop speaking, localvoxtral streams text as the audio arrives, powered by Mistral AI's Voxtral Mini 4B Realtime running on your own Apple Silicon. It is built first for prompting coding agents by voice, and it stays a solid general dictation app everywhere else. Everything runs on-device, with no account and no subscription. Nothing leaves your Mac unless you decide it should.
curl -fsSL https://raw.githubusercontent.com/T0mSIlver/localvoxtral/main/scripts/install.sh | bashOr brew install --cask T0mSIlver/localvoxtral/localvoxtral, or download the latest .dmg from Releases. Requires an Apple Silicon Mac on macOS 15+. A first-launch wizard handles permissions and the engine download; if Gatekeeper complains about a hand-installed DMG, see the install guide.
- Built for coding agents. Dictate prompts straight into any CLI agent (opencode and Mistral Vibe get their own integrations), in any terminal: Warp, WezTerm, kitty, Alacritty, and more. Polishing understands developer speech: "dash dash force" becomes
--force, "use auth dot t s" becomesuseAuth.ts(details). - Claude Code aware. Dictation joins the exact session under your cursor: Ghostty, iTerm2, Terminal.app, a single herdr or cmux pane, over SSH, or a claude.ai/code Remote Control tab in your browser. Polishing is grounded in that session's screen, your last prompt, the files Claude just touched, and the repo's vocabulary (details).
- One key, two modes. Tap for a reviewable overlay with optional LLM polishing, hold to stream words live into the focused app (shortcuts).
- Private. Audio, transcription, and polishing are local processes. No telemetry, no account, no cloud fallback (how it works).
- Menu bar native. Instant popover with dictation status at a glance, microphone picker, auto-copy of the final text, and the raw transcript one click away after a polished commit.
- Bring your own server. Dictation and polishing can each point at any OpenAI-compatible endpoint, or at Mistral's hosted API with one key, instead of the built-in local engines (details).
- Multilingual. Dictate in English, French, or any language Voxtral understands. Polishing answers in the language you spoke (English and French are covered by the test suite).
Tip
If localvoxtral is useful to you, a ⭐ on this repo helps others find it.
- Install: one-liner, requirements, Gatekeeper notes
- Dictating: shortcuts, output modes, settings, screenshots
- Terminals & coding agents: Claude Code session joins, the SSH remote plugin, repo vocabulary
- Integration matrix: what each harness and terminal gets (join, screen, repo, prompt) and why the gaps are gaps
- Under the hood: privacy, the bundled engines and their pinned models, hosted and self-hosted alternatives
- Building from source · Roadmap