# voicemode

> Natural (2-way) voice conversations with Claude Code

- **URL**: https://www.freshcrate.ai/projects/voicemode
- **Author**: mbailey
- **Category**: MCP Servers
- **Latest version**: `v8.6.2` (2026-05-27)
- **License**: MIT
- **Source**: https://github.com/mbailey/voicemode
- **Homepage**: https://getvoicemode.com/
- **Language**: Python
- **GitHub**: 1,103 stars, 151 forks
- **Registry**: github (`mbailey/voicemode`)
- **Tags**: `anthropic`, `asr`, `claude`, `claudecode`, `kokoro`, `livekit`, `mcp`, `mcp-server`, `python`

## Description

Natural (2-way) voice conversations with Claude Code

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v8.6.2` | 2026-05-27 | High | ### Fixed  - **Kokoro service no longer silently dies after `UVICORN_LIMIT_MAX_REQUESTS` requests on Linux** (VM-1398, [#448](https://github.com/mbailey/voicemode/issues/448) — reported by @JulesGosnell) — The systemd unit `voicemode-kokoro.service` combined `Restart=on-failure` with `Environment="UVICORN_LIMIT_MAX_REQUESTS=25"` (the memory-leak workaround from VM-358). Hitting the request limit makes uvicorn exit cleanly (status 0), which `on-failure` treats as a successful shutdown — so the s |
| `v8.6.1` | 2026-04-21 | High | ### Fixed  - **Tmux auto-focus no longer steals pane focus** -- When `VOICEMODE_AUTO_FOCUS_PANE` is enabled, converse now only raises the agent's tmux window without changing which pane has focus. Previously, `select-pane` was called alongside `select-window`, which would yank the cursor away from whatever pane the user was working in — especially disruptive in multi-pane layouts.   ## Installation  ### Quick Start (Recommended)  ```bash # Install UV package manager (if not already installed) c |
| `v8.6.0` | 2026-04-16 | High | ### Added  - **Auto-focus tmux pane on converse** (VM-922) -- Set `VOICEMODE_AUTO_FOCUS_PANE=true` to automatically focus the agent's tmux pane when converse acquires the conch. Supports multi-session setups via `switch-client`, and respects a `focus-hold` sentinel so other tools (e.g. show-me) can temporarily suppress focus changes. New `VOICEMODE_FOCUS_HOLD_SECONDS` setting. See the Multi-Agent Voice section in the configuration guide. - **Restored `voicemode connect auth` CLI commands** (VM- |
| `v8.5.1` | 2026-03-13 | Low | ### Added  - **Show-me plugin in marketplace** - Added show-me as an external plugin (source: mbailey/show-me) to the VoiceMode plugin marketplace  ### Fixed  - **Pass WHISPER_LANGUAGE config to STT API** ([#253](https://github.com/mbailey/voicemode/pull/253) by @htrex) - The `VOICEMODE_WHISPER_LANGUAGE` config existed but was never passed to the transcription API. Local whisper.cpp defaults to English when no language parameter is given, producing incorrect transcriptions for non-English audio |
| `v8.5.0` | 2026-03-07 | Low | ### Added  #### PermissionRequest Notification Sound (VM-892)  - **PermissionRequest hook event** - Plays an audio notification when Claude Code needs user approval for a tool, so you don't miss permission prompts while away from the screen - **Bypasses conch lock** - PermissionRequest sounds play even during active voice conversations, ensuring you always hear when approval is needed  #### Mute Converse Sounds (VM-898)  - **Auto-mute voicemode converse tool sounds** - PreToolUse/PostToolUse so |
| `v8.4.0` | 2026-03-05 | Low | ### Added  #### Soundfont Toggle (VM-312)  - **`voicemode soundfonts on/off/status` CLI commands** - Session-scoped soundfont toggle using a sentinel file for zero-overhead checking. Disable tool-use sounds without editing config files - **`--config` flag for persistent toggle** - `soundfonts on/off --config` also updates `voicemode.env` so the setting persists across restarts - **Environment variable awareness** - Status shows the effective state from both sentinel file and `VOICEMODE_SOUNDFON |
| `v8.3.0` | 2026-02-24 | Low | *February 24, 2026 — One year since Claude Code launched. This release celebrates with VoiceMode Connect: make inbound voice calls to your Claude Code agents from anywhere.*  ### Added  #### VoiceMode Connect — Inbound Voice Calls  - **connect_status MCP tool** (VM-770) - Manage agent presence directly from Claude Code conversations; always-on visibility on the voicemode.dev dashboard - **Auto-connect on startup** (VM-766) - WebSocket connection established automatically when the MCP server sta |
| `v8.2.1` | 2026-02-19 | Low | ### Fixed  - **FastMCP 3.0 breaking change** - Pin FastMCP dependency to <3.0 to prevent installation failures caused by FastMCP 3.0.0 breaking changes ([#278](https://github.com/mbailey/voicemode/issues/278))   ## Installation  ### Quick Start (Recommended)  ```bash # Install UV package manager (if not already installed) curl -LsSf https://astral.sh/uv/install.sh \| sh  # Install VoiceMode and configure services uvx voice-mode-install  # Add to Claude Code MCP claude mcp add --scope user voicem |
| `v8.2.0` | 2026-02-13 | Low | ### Added  - **STT Prompt for Vocabulary Biasing** - Set `VOICEMODE_STT_PROMPT` to hint Whisper on frequently misrecognized words (e.g., proper nouns, technical terms) - **Claude Code Hooks CLI** (VM-618) - `voicemode claude hooks add/remove/status` to manage soundfont hooks without manual JSON editing - **VoiceMode Connect Device Visibility** (VM-633) - WebSocket connection shows your device on the voicemode.dev dashboard with online/offline status - **Latest Audio Symlinks** (VM-614) - `~/.vo |
| `v8.1.0` | 2026-02-02 | Low | ### Added  - **VoiceMode Connect** (VM-549, VM-561)   - Remote voice control via voicemode.dev mobile and web apps   - `voicemode connect login` - OAuth authentication with PKCE flow   - `voicemode connect logout` - Clear stored credentials   - `voicemode connect status` - Check connection and auth status   - `voicemode connect standby` - Wait for remote wake commands   - Connect service for launchd - run at startup with `voicemode service connect enable`   - Heartbeat thread keeps connection a |

## Citation

- HTML: https://www.freshcrate.ai/projects/voicemode
- Markdown: https://www.freshcrate.ai/projects/voicemode.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/voicemode/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._