← all repositories
spaceamoeba-t/tapq

Nod yes to Claude Code: TapQ puts your agents in your ear

A macOS runtime that speaks coding-agent prompts through your AirPods and takes your answer as a nod, a shake, or a word — so supervision stops requiring a screen.

★647 stars Swift Coding AssistantsAgents
tapq
Not currently ranked.
star history

What it does

TapQ is a background voice agent that hooks into Claude Code, Codex, Cursor, and OpenCode. When an agent stops for an approval, question, or choice, TapQ speaks the prompt in your ear — named by agent — and waits for your answer: a spoken “yes,” a double nod, or a tilt-and-tap through options. It also reports finished runs, takes follow-up instructions (“when Claude Code finishes, rerun the tests”), and answers questions like “what did Codex change?” by reading the agents’ own transcripts.

The interesting bit

The gesture recognition is genuinely clever: AirPods already report head motion, and TapQ uses the same motion sensors for wearer attribution — your own speech produces a detectable vibration, so with --wearer-gate a colleague or a nearby video can’t answer a prompt for you. Also notable: nothing TapQ does unprompted can approve anything. Its risk reasoner can only raise the confirmation bar, never lower it.

Key highlights

  • Prompts from multiple sessions queue into one spoken stream, each attributed to its agent
  • Default voice backend is fully on-device with a fixed vocabulary and no API key; OpenAI realtime is opt-in and only active during a response window
  • Conversation memory is a local wearer-conversation.jsonl, capped at 30 days or a couple of megabytes, wipeable with tapq memory clear
  • Every failure mode — timeout, missed gesture, dead voice pipe — falls back to the agent’s normal on-screen prompt
  • Apache 2.0, one Swift package, with a portable core that builds and tests on Linux (no earbuds or agents there yet)

Caveats

  • Pre-1.0 (0.5.0-beta.2) and source-only — no Homebrew formula or signed download yet
  • Cursor questions stay on screen until Cursor exposes them; stem taps need AirPods Pro 2 or later
  • Requires macOS 14+, and tested on AirPods Pro specifically

Verdict

If you supervise multiple coding agents and own AirPods, this is the most thoughtful take on hands-free agent control we’ve seen — privacy boundaries are designed in, not bolted on. If you run one agent and sit at your desk anyway, it’s a solution to a problem you don’t have.

Frequently asked

What is spaceamoeba-t/tapq?
A macOS runtime that speaks coding-agent prompts through your AirPods and takes your answer as a nod, a shake, or a word — so supervision stops requiring a screen.
Is tapq open source?
Yes — spaceamoeba-t/tapq is open source, released under the Apache-2.0 license.
What language is tapq written in?
spaceamoeba-t/tapq is primarily written in Swift.
How popular is tapq?
spaceamoeba-t/tapq has 647 stars on GitHub.
Where can I find tapq?
spaceamoeba-t/tapq is on GitHub at https://github.com/spaceamoeba-t/tapq.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.