VoiceLayer

Your AI agent can't hear you and respond to you. VoiceLayer gives it ears and a voice.

Voice I/O for AI coding assistants. Press F5, speak to Claude Code, get on-device transcription in under 1.5 seconds. Your AI speaks back. Works with any MCP client.

  You ──🎤──> whisper.cpp ──> Claude Code ──> edge-tts ──🔊──> You
         STT (local)           MCP tools         TTS (free)

Local-first. Free. Open-source. No cloud APIs, no API keys, no data leaves your machine.

Website · Docs · npm

Install

macOS (recommended) — the tap ships the CLI/MCP package and the notarized notch app:

brew tap etanhey/layers
brew install etanhey/layers/voicelayer         # CLI + MCP server
brew install --cask etanhey/layers/voicebar    # VoiceBar notch app (owns the mic)
voicelayer setup                               # one-time runtime setup

Install the cask too — the formula alone gives you the CLI/MCP but no notch UI.

npm — if you only want the MCP server:

bun add -g voicelayer-mcp        # or: npm i -g voicelayer-mcp
brew install sox socat && pip3 install edge-tts
brew install whisper-cpp         # optional, for local STT

# whisper model (~1.5 GB) — needed for local STT
mkdir -p ~/.cache/whisper && curl -L -o ~/.cache/whisper/ggml-large-v3-turbo.bin \
  https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin

Point your MCP client at the daemon

VoiceLayer runs as one persistent daemon on a Unix socket; every session connects through a lightweight socat shim instead of spawning its own process. Add to .mcp.json:

{
  "mcpServers": {
    "voicelayer": {
      "command": "socat",
      "args": ["STDIO", "UNIX-CONNECT:/tmp/voicelayer-mcp.sock"]
    }
  }
}

Or migrate every repo at once: bash scripts/migrate-to-daemon.sh (--dry-run to preview). On macOS, grant your terminal microphone access (System Settings → Privacy → Microphone).

Updates, kill-switches, and cross-machine setup: docs/install-and-update.md.

Related MCP server: io.github.chicogong/ffvoice

The two tools

Both ship full MCP ToolAnnotations. Neither is destructive; both set openWorldHint: false.

How voice_ask works: waits for any playing audio to finish → speaks the question via edge-tts → records the mic and resamples to 16kHz → Silero VAD detects when you stop talking → whisper.cpp transcribes locally (~200-400ms on Apple Silicon) → returns the text to your agent.

Full tool parameters: docs/tools-reference.md.

VoiceBar — the notch surface (macOS)

The canonical UI (SwiftUI + AppKit). It tucks around the MacBook camera housing instead of floating over your work:

• Liquid-Glass wings flank the camera housing, with a graceful fallback on older macOS.

• Teleprompter with word-by-word karaoke highlighting as your agent speaks.

• Idle-hover to summon — collapsed it draws no pixels; hovering reveals recent transcripts, the dictionary, and replay.

• Morph animations between idle ↔ recording ↔ speaking, Reduce-Motion aware.

STT backends

Auto-detected. Override with QA_VOICE_STT_BACKEND=whisper|wispr|auto.

Platform support

Part of Golems

Pair with BrainLayer to remember voice conversations across sessions.

More

• Architecture — why one daemon instead of a process per session

• Configuration — environment variables and test commands

• Contributing

License

Apache-2.0