Murmur

Voice interface for terminal AI coding agents

Works with Claude Code, Aider, Cursor CLI, GitHub Copilot CLI, and any agent that runs in a terminal.

Launch App Download

Launch App opens the web UI — requires the desktop app running in the background.

What you get

Voice Input

Speak naturally -- local Whisper STT transcribes on-device with zero cloud latency. Auto-listen detects speech and starts recording hands-free.

Voice Output

Responses read aloud via local Kokoro TTS. 60+ voices, adjustable speed (0.5x--3x), paragraph-level highlighting as your agent speaks.

Live Terminal

Watch your AI agent working in real-time. Full ANSI color, scrollback, arrow key navigation, and interactive prompt detection.

4 Interaction Modes

Talk (full voice), Type (type in, hear back), Read (speak in, read response), and Text (keyboard only). Switch with one tap.

Cross-Platform Desktop

macOS and Windows via Electron. Floats above all windows, draggable header, visible on all workspaces. Auto-updates from GitHub.

Auto-Updating

Content updates (UI, server logic) pulled from GitHub on every launch. Shell updates via GitHub Releases. Always current, zero effort.

Flow Mode

A focused, distraction-free conversation view. One tap hides all chrome — just the mic, flowing prose in a serif font, and nothing else. Barge-in and auto-listen keep the exchange natural.

Getting Started

Download, open, talk. That's it.

1

Download and Open

Download the app for macOS or Windows. Open it -- Murmur checks for prerequisites, starts your AI agent session, and connects automatically. A guided tour walks you through all controls on first launch.

2

Talk or Type

Tap the talk button or press Right Cmd to start recording. Speak your request, release to send. The response appears as conversation bubbles and is read aloud. Or just type in the text input.

3

Choose Your Mode

Tap the mode button to cycle between Talk, Type, Read, and Text. Each mode adjusts mic and speaker behavior. Expand the terminal panel to see the agent's full output and navigate with arrow keys.

Interaction Modes

Switch modes with a single tap on the mode button.

Talk
Full voice conversation. Speak in, hear back.
Mic on + Speaker on
Type
Type your input, hear the response aloud.
Mic off + Speaker on
Read
Speak your input, read the response.
Mic on + Speaker off
Text
Keyboard only. No audio input or output.
Mic off + Speaker off

Keyboard Shortcuts

Push to talk Right Cmd
Stop TTS / cancel Escape
Send text input Enter
Terminal: previous command Up / Down
Debug panel Ctrl + Shift + D
Chat font zoom + / -

Remote & Mobile Access

Use Murmur from your iPhone or any browser on your local network via Tailscale.

Setup (one-time)

  1. Install Tailscale on your Mac and iPhone
  2. Sign in with the same account on both devices
  3. On your Mac, run tailscale status to get your hostname (e.g. device.tailnet.ts.net)
  4. On your iPhone, open Safari and go to https://<hostname>:3458
  5. Or click Launch App above and enter your Tailscale hostname — it's saved for next time
  6. Use the hostname (not the IP) so the SSL cert matches and icons load correctly on iPhone

Multi-device audio

When both the desktop app and your phone are connected, the 🔊 dot in the top-right shows which device has audio output. The last-connected device automatically claims audio. Tap the 🔊 dot on any device to claim audio for it.

Use Kokoro voices (Heart, Sky, Adam, etc.) for audio on remote devices — device voices like Samantha only play on the Mac.

Requirements

  • Desktop Murmur app must be running on your Mac (server runs locally)
  • Both devices on the same Tailscale network
  • Whisper & Kokoro running on the Mac for STT/TTS

Download

Grab the latest release for your platform.

macOS Apple Silicon & Intel (.dmg) Windows 64-bit (.exe)

Run without installing

No app download needed. Paste this in any terminal — then open localhost:3457 in your browser.

git clone https://github.com/hdt325/murmur.git && cd murmur && npm install && npm start

The desktop app adds a floating window, dock icon, and global hotkey — but the server works standalone in any browser.

Build from source

git clone https://github.com/hdt325/murmur.git
cd murmur && npm install
cd electron && npm install && cd ..
npm run electron
▶ Prerequisites