voicemode

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

.claude/scripts/voicemode-hook-receiver

install.sh

AGENTS.md

| `VOICEMODE_MLX_AUDIO_BASE_URL` | `http://127.0.0.1:8890/v1` | the mlx-audio endpoint |

`voicemode control pause | resume | stop | skip-forward | skip-back` drives a live converse turn: pause it, barge in (cut the utterance and take the mic), finish answering early, hear the question aga

Audit 0.4.1 · source sha a40d930a5d03 · 14 Oct 2026Report an issue or request a re-scan

• Publishermbailey GitHub userOwner of the repository this skill is read from
• Source foldermbailey/voicemode/.claude/skills/voicemodeThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdicta40d930a5d03A new audit runs when the source changes
• Repository statusNot archivedLast push 8 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Talk with the user by voice through the converse tool: speak, listen, run a short survey, pick or clone a voice, share the channel with other agents, recover when voice drops. Use when the user mentions voice, speaking,…

---
name: voicemode
description: Talk with the user by voice through the converse tool: speak, listen, run a short survey, pick or clone a voice, share the channel with other agents, recover when voice drops. Use when the user mentions voice, speaking, talking, listening, a voice name, an impression, or background music.
---

# VoiceMode

You speak with the `converse` tool. Its description and schema are the contract; this page is how to use it well. No `converse` in your tool list? See [recovery].

## How a conversation goes

- `converse("...")` speaks, then listens: the user's reply comes back as the result, and they never have to address you. The turn stays with you for as long as you keep listening: [listening].
- Narrate with `wait_for_response=false` and fire the work in the same response (Bash, Agent, Read...), so speech and action overlap. Then listen with the next call: a speak-only call leaves nobody listening.
- Short utterances, one question per turn. More than one thing to ask? `turns` runs them as a survey: [surveys].
- Leave `listen_duration_max` unset. The user owns that ceiling, and silence detection ends the turn for you.
- Leave `voice` unset unless asked; a name is lowercase with its prefix (`bm_daniel`, `af_sky`). Personas, cloning, impressions: [voices].
- Other agents on the channel: `hold_conch=true` when you will continue the thread; `wait_for_conch` to queue: [conch].
- "Hang on" or "wait" at the end of a reply pauses and re-listens on its own. For minutes, run `sleep N` as a background Bash call; converse again when it finishes.

## When something is off

- Tool missing, `-32000 Connection closed`, permission prompts, an empty reply after they spoke, misheard names: [recovery].
- Pause, barge in, replay or skip during a turn; media keys and Stream Deck: [controls].
- Background music: [music].

## References

Every bracketed name above is a file in `references/`; this list is here so the links render.

[conch]: references/conch.md
[controls]: references/controls.md
[listening]: references/listening.md
[music]: references/music.md
[recovery]: references/recovery.md
[surveys]: references/surveys.md
[voices]: references/voices.md

Excerpt, first 2,191 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

1. 2026-10-14
   !CAUTION B 89 / 100

   first audit · source a40d930a5d03

Questions about voicemode

• github.com/mbailey/voicemode/tree/master/.claude/skills/voicemod — the audited source at commit a40d930a5d03 and every finding aboveObserved · 14 Oct 2026

Spotted something wrong? Report a correction · Methodology