Tapq

TapQ

TapQ lets you work with your coding agents by voice. You speak to Claude Code or Codex by
name; TapQ relays your words into the agent's session, reads its permission requests and
questions aloud, takes your spoken answer, and speaks its replies. The agents run in your
project folder as they would in a terminal. TapQ is the voice between you and them.

This repository is tapq-kernel, that loop: a command-line program for macOS, written in
Swift, that runs on your own OpenAI API key.
0.6.0 replaces the earlier TapQ. The broker and its hooks, the Cursor and OpenCode
integrations, AirPods gestures, on-device speech and the wake word are gone. Their last
state is kept under the legacy-final
tag.

Contents

- What it does
- Requirements
- Quick start
- Command line
- Configuration
- Privacy and data
- How it works
- Development
- Community
- License

What it does

- Speak to an agent by name. "Claude, add a test for the parser." "Codex, why is the
  build failing?" A small text model reads the whole sentence, with both agents' state, and
  turns it into one action for one agent. When a bare "yes" could be for either, TapQ asks
  "Claude Code or Codex?".
- Hear what needs you. Permission requests and questions are read aloud as they arrive.
  A shell command is described in words rather than read out symbol by symbol. An answer
  counts only for a request you have heard in full.
- Answer by voice. Say yes, no, "no, use the other file", or pick an option. Ask not to
  be asked again, and TapQ takes the agent's own offer to stop asking, where it makes one.
- Hear the reply. A short reply is read as it is. One over 120 characters, or with code
  or a link in it, is summarized in a sentence or two; "read it all" reads the original.
- Ask where things stand. "What is Codex…