Multi-modal voice agent for your AI agents. Talk with Claude Code, Codex, and others by voice: answer their prompts, give instructions, ask what they did. Or just nod.
# Add to your Claude Code skills
git clone https://github.com/spaceamoeba-t/tapqGuides for using ai agents skills like tapq.
Last scanned: 10/3/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-10-03T09:41:21.030Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how tapq compares with popular alternatives.
tapq is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by spaceamoeba-t. Multi-modal voice agent for your AI agents. Talk with Claude Code, Codex, and others by voice: answer their prompts, give instructions, ask what they did. Or just nod. It has 648 GitHub stars.
Yes. tapq passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/spaceamoeba-t/tapq" and add it to your Claude Code skills directory (see the Installation section above).
tapq is primarily written in Swift. It is open-source under spaceamoeba-t on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh tapq against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
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-finaltag.
tapq-kernel says
what was cut off and resends nothing.PATH, signed in: Claude Code 2.1.260 through 2.1.293, or
Codex 0.161. Listing Claude Code's conversations needs 2.1.283 or newer.git clone https://github.com/spaceamoeba-t/tapq.git
cd tapq
swift build -c release
export TAPQ_OPENAI_API_KEY=sk-...
.build/release/tapq-kernel run --workspace ~/code/my-project
The first run asks for the microphone on behalf of your terminal app. Then speak: "Claude, what does this project do?" Stop with Ctrl-C or Ctrl-D.
tapq-kernel run --workspace <abs-dir> [options]
tapq-kernel clear --workspace <abs-dir>
tapq-kernel --help
run listens and relays until you stop it. clear deletes what TapQ kept for the folder:
its journal, the agents' session ids and its diagnostics. The agents' own history is theirs
and is not touched.
| Option | What it does |
|---|---|
--workspace <abs-dir> |
The folder the agents work in. Required, absolute. |
--language <code>|auto |
The language you speak, as an ISO 639-1 code (default en). auto lets the service tell each sentence's language, for a user who mixes two. |
--permission-mode acceptEdits|manual |
How Claude Code asks (default acceptEdits). bypassPermissions is refused: approvals would never reach you. |
--auto-mode |
Each agent approves what it judges safe, Claude Code in its auto permission mode and Codex through its auto_review reviewer; TapQ asks you the rest. Off by default. |
--subscription claude |
Claude Code signs in with your claude.ai subscription instead of an API key from the environment. Checked at start. Off by default; Anthropic's terms govern using a subscription login through another tool, so check them first. |
--agents <agents> |
Only these agents may start: claude, codex. Both by default. |
--realtime-endpoint <ws-url> |
A server that speaks OpenAI's Realtime wire, for the voice sessions. |
--openai-base-url <http-url> |
A base URL for the text models instead of https://api.openai.com/v1. |
Exit status: 0 is a clean stop, 64 a usage error (nothing started), and 70 a fatal or a
refused start, with one tapq-kernel: fatal in <subsystem>: <reason> line on standard
error.
Standard output carries one JSON status line per change, for a program that hosts the kernel. Standard input is that host's lifeline: its end of file stops the kernel.
| Variable | Default | |
|---|---|---|
TAPQ_OPENAI_API_KEY |
none | Required. Every voice session and text-model call runs on it. |
TAPQ_CLAUDE_MODEL |
claude-haiku-5-5 |
The model Claude Code is started on, whatever your own settings say. |
TAPQ_CODEX_MODEL |
gpt-5.6-luna |
The model Codex's threads use. |
TAPQ_INTENT_MODEL, TAPQ_SUMMARY_MODEL, TAPQ_COMMAND_MODEL, TAPQ_PROGRESS_MODEL, TAPQ_TITLER_MODEL, TAPQ_PICKER_MODEL |
gpt-5.6-luna |
TapQ's own text models: routing, reply summaries, command descriptions, status, conversation titles, and which conversation your words carry on. |
TAPQ_STT_MODEL |
gpt-4o-transcribe |
Speech to text. |
TAPQ_TTS_MODEL, TAPQ_TTS_VOICE |
gpt-realtime-2.1-mini, cedar |
TapQ's voice. |
TAPQ_DEBUG |
off | 1 puts every diagnostic on standard error, not only warnings and errors. |
TAPQ_ALLOW_UNSUPPORTED_AGENT_VERSIONS |
off | 1 runs an agent outside the supported range, with a warning. |
TAPQ_BROKER_DIR |
see below | Where TapQ keeps its state. |
TapQ keeps each folder's state in ~/Library/Application Support/TapQ/runtime/kernel/,
in a directory named by a hash of the folder's path and created 0700: the journal (what
you said to each agent, verbatim, and what came of it), the agents' session ids, and
diagnostics.log.
tapq-kernel run runs, and TapQ's sentences are voiced there.--realtime-endpoint or --openai-base-url, opens no
network port, and keeps no copy of the audio.--auto-mode, where the agents' own reviewers decide first.The kernel is one loop. Speech comes in as utterances; a text model turns each into one action for one agent; a deterministic gate lets an answer through only for a request the user heard; the agent runs as a child process; what it asks and says is queued and spoken. Each step is written to the folder's journal, so a restart can say what was lost.
| Target | What it holds |
|---|---|
TapQKernel |
The loop: the journal, the gate, every sentence TapQ speaks, the status channel. No Apple framework, network or subprocess. |
TapQKernelClaude |
Claude Code as a stream-json delegate. |
TapQKernelCodex |
Codex as a JSON-RPC delegate over codex app-server. |
TapQOpenAI |
The text models, over the Responses API. |
TapQVoiceIO, TapQVoiceBackends |
Speech in and out over OpenAI's Realtime API. |
TapQAudioIO, TapQAudioCaptureBridge |
Microphone capture and playback (macOS). |
TapQPOSIXSupport |
Child processes in their own process groups, and line channels. |
TapQContracts |
Types and protocols the targets share. |
tapq-kernel |
The executable: command line, startup checks, composition. |
Everything but the audio targets builds and tests on Linux; tapq-kernel run needs macOS.
swift build
swift test
scripts/check-release-version.sh
scripts/check-public-boundary.sh # needs ripgrep
On a Mac with only the Command Line Tools ther