# CODE-1884-voice-input-slash-command

CODE-1884-voice-input-slash-command is a Claude Code subagent for adding /voice voice input to a headless TUI. Esc or Enter ends recording and starts transcription.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dominikmartn/harp/tree/HEAD/agents/specs/CODE-1884-voice-input-slash-command.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/code-1884-voice-input-slash-command

## What it does

This subagent helps implement voice input in a headless TUI through the no-argument `/voice` slash command. It starts microphone capture, shows an animated listening outline and footer state, then sends the recording for transcription when Esc or Enter is pressed. The returned text is inserted into the composer without submitting it to the agent.

The task covers `Listening` and `Transcribing` states, Escape cancellation, inline-menu priority, and restoration of normal shell behavior after the session ends. Recording relies on the shared `cpal` backend together with the existing `VoiceInput` and `VoiceTranscriber`; macOS also checks microphone authorization. It requires an authenticated local TUI session, AI enabled, voice team policy enabled, the `voice_input` capability compiled, and voice requests available.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/CODE-1884-voice-input-slash-command.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/CODE-1884-voice-input-slash-command.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/CODE-1884-voice-input-slash-command.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dominikmartn/harp/tree/HEAD/agents/specs/CODE-1884-voice-input-slash-command.md

## When to use it
- add a no-argument `/voice` command to the TUI
- start microphone capture from the slash menu
- show listening and transcription states in the footer
- stop recording with Esc or Enter
- insert the transcription into the composer

## Example prompts
- Add the `/voice` slash command for voice input in the headless TUI.
- Implement Esc and Enter handling so recording stops and transcription begins.
- Test composer insertion and microphone-denial handling for the voice session.

## Similar
- [type4me-macos-voice-input](https://affpapa.org/en/nevibecode/skills/type4me-macos-voice-input.md) — skill · 869 installs
- [codex-debugging](https://affpapa.org/en/nevibecode/skills/codex-debugging.md) — skill · 108 installs
- [review](https://affpapa.org/en/nevibecode/skills/mag123c-review.md) — skill · ★ 196 repo stars
- [ratatui-tui](https://affpapa.org/en/nevibecode/skills/ratatui-tui.md) — skill · 959 installs
- [opentui](https://affpapa.org/en/nevibecode/skills/opentui.md) — skill · 64600 installs
- [codex-tui-proof](https://affpapa.org/en/nevibecode/plugins/codex-tui-proof.md) — plugin · ★ 1596 repo stars

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
