Voxa

Talk to Claude Code from anywhere.
When it finishes, your phone rings.

Install

Pick your way, same as voxa.space/setup:

macOS / Linux

curl -fsSL https://voxa.space/install.sh | sh

Windows (PowerShell)

irm https://voxa.space/install.ps1 | iex

npm

npm install -g voxa-code

Python

uv tool install voxa-code

Then run voxa on your laptop, scan the QR code with the Voxa iOS app (any phone browser works too), and start talking. Zero config, no API keys: voice runs through the hosted relay, terminal control never leaves your laptop.

Requires: Claude Code installed and logged in.

How it works

• Speak, don't type. Pick a project, give instructions, hear results read back, fully hands-free.
• Attach any terminal. iTerm2, Terminal.app, tmux, Ghostty, Warp, VS Code: say "use my open terminal."
• It calls you back. Leave a task running and pocket your phone. When Claude finishes (or needs input), you get a real incoming call. Answer to land in the live session.

phone ──── voice ────► laptop ────► Claude Code
  ▲                                     │
  └───────── rings when done ◄──────────┘

From source

git clone https://github.com/Ti-03/voxa.git && cd voxa
python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/python -m server.cli

Full guide (including fully self-hosted mode, your own keys, no relay): docs/RUNNING.md

FAQ

Is it open source?

Yes. Everything in this repo is MIT: the laptop server, the iOS app, the phone web client, the marketing site, and the cloud pieces (relay + push). You can self-host all of it, or skip that entirely and use our already-hosted services: the default install connects to them out of the box.

Is it free?

Self-hosting is free forever: run the server with your own API key, no relay needed (guide). The hosted zero-config relay is free to get started, with paid plans for more agent minutes (pricing).

What platforms does it support?

The laptop side runs on macOS, Linux, and Windows. The phone side is the Voxa iPhone app, with any mobile browser as a fallback. Attaching to already-open GUI terminals (iTerm2, Terminal.app, Ghostty, Warp, VS Code) is macOS only; tmux attach works everywhere.

Security

Security model and vulnerability reporting: SECURITY.md