OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Voice Agents

Tapq

Tapq is an open-source Swift application that connects coding agents to a Mac-based voice runtime. It speaks agent prompts, accepts spoken responses and instructions, answers questions about agent activity, and supports gesture controls with AirPods motion sensors.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Tapq — OpenViST project profile in Voice Agents.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use Tapq when a supported coding agent is running on a Mac and you want to handle prompts, instructions or status questions through voice rather than switching back to the agent interface.

Who it is for

  • Developers working with Claude Code, Codex, Cursor or OpenCode who want to respond to agent prompts by voice.
  • People supervising multiple coding-agent sessions who want spoken notices and a voice-based way to check what is waiting or finished.

Documented uses

  • Hear agent approval requests, questions and choices through earbuds.
  • Approve or decline requests by voice or supported AirPods gestures.
  • Give an agent an instruction or follow-up task without returning to its screen.
  • Ask about agent status or what an agent changed.
Before you choose

Requirements & limits

The documented quick start is source-based and requires macOS 14 or later, Swift 6 and Xcode 16 or a compatible toolchain. AirPods with headphone motion are needed for gestures; voice can fall back to the Mac’s default audio devices. Conversational features using the OpenAI realtime backend require an API key.

  • Tapq uses agent hooks or a plugin to relay prompts and responses to a runtime on the Mac.
  • AirPods motion gestures are processed on-device; without supported AirPods, gestures and related controls are unavailable.
  • The default on-device voice backend matches a fixed vocabulary; conversational instructions and questions use the OpenAI realtime backend.
  • If Tapq cannot handle a prompt or a response is missed, the agent’s on-screen prompt remains the fallback.
  • The documented quick start requires building from source rather than installing through a Homebrew formula or signed download.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Build Tapq and connect a coding agent

Set up the local runtime and install Tapq’s integration for one supported coding agent.

Before you start

  • Swift 6 and macOS 14 or later, with Xcode 16 or a compatible toolchain.
  • Claude Code with hook support, local Codex CLI 0.142.5 or later, Cursor, or OpenCode 1.18.15 or later.
  • AirPods with headphone motion for gesture controls; voice interaction can use the Mac’s default audio devices without AirPods.

Steps

  1. Clone the repository, enter its directory, then run swift build && swift test.

  2. Run scripts/run-runtime-app.sh calibration run to launch the calibration app container for macOS Motion, Speech and Microphone permissions.

  3. Install the relevant agent integration with the documented tapq integration command: claude install, codex install, cursor install, or opencode install.

  4. For Codex, open Codex, run /hooks and trust the Tapq hooks. Restart Cursor if an open session does not load the hooks, or restart OpenCode to load its plugin.

Expected outcome

The local Tapq runtime is built and calibrated, and a supported agent has its Tapq hook or plugin installed.

Guide limitations

  • The guide covers building, calibration and integration setup; using the service also requires starting Tapq and keeping it running.
  • The documented conversational features require the OpenAI realtime backend and an OPENAI_API_KEY in the launcher environment.
  • The repository describes a source-only quick start, with no Homebrew formula or signed download.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
14 October 2026
Original website title
spaceamoeba-t/tapq · Official homepage title · retained in its source language
How we review sourcesSuggest a correction