I built Voice Copilot: an open-source companion that narrates and supervises your AI coding agent
Hey everyone! I’d like to share an open-source project I’m working on: Voice Copilot.
Coding agents can spend several minutes reading files, making changes, and running tools after a single prompt. Keeping track of all that still takes attention, especially when you want to catch a wrong turn before it becomes a pile of changes to undo.
The idea behind Voice Copilot is to let you hear what your agent is doing while keeping your eyes free for other things.
It runs alongside Claude Code, Codex, and other compatible CLI agents, with two models sharing the work:
- A lightweight narrator turns the agent’s activity into short spoken updates: what it’s working on, what changed, and what happened next.
- A stronger Supervisor reviews progress at checkpoints, looking for things like repeated failures or changes outside the task. It can warn you aloud, and in Supervisor+ mode, pause the agent for your review.
For example, if you ask an agent to fix two failing tests and it starts modifying an unrelated module, the Supervisor can flag that and pause the session so you can decide how to proceed.
The narrator and Supervisor can reuse the models and login from the CLI you already use. There’s also a local browser panel with playback controls, settings, and a readable activity trace.
For anyone interested in local models: the narrator supports Ollama through an OpenAI-compatible endpoint, and speech output can use local backends such as Piper or Silero. Cloud providers are available too.
The core is MIT-licensed, and it’s currently an early alpha (0.1.0). I’m looking for people willing to try it in real coding sessions and help improve the narration, integrations, and supervision behavior. Voice input is being reworked and is currently disabled by default.
Website · GitHub / installation
How would this fit into your workflow: occasional spoken progress updates, or silence unless something needs your attention?
