Questions before you pair a terminal to your phone.

Veelops is a voice coding agent for the terminal coding tools you already run. These answers cover the voice loop, setup, security, OpenAI API cost, subscriptions, and what actually happens when you speak.

Basics

How does Veelops work?

For quick start:

  1. Download the app.
  2. Download the CLI.
  3. Pair your phone with the agent.
  4. Open a terminal session and start talking to the coding tools already running on your machine.

You install the Veelops Agent CLI on the machine that has your code, shell, tmux sessions, and coding CLIs. Then you install the mobile app and pair it with that agent using a QR code.

The mobile app connects to the agent through an encrypted relay and controls sessions inside your existing terminal tools. Veelops does not replace Codex, Claude, Gemini, OpenCode, or your shell; it gives you mobile and voice control over the sessions you already run there.

How is Veelops different from Whispr Flow or regular speech-to-text?

Speech-to-text tools turn your words into text. That is useful for dictation, but it is still mostly one-way input.

Veelops gives you a realtime coding session with an actual conversation going back and forth. You can speak the next instruction into Codex, Claude, Gemini, OpenCode, tmux, or your shell, and Veelops can talk back with reports, useful terminal state, questions about what to do next, and prompts when the session needs a decision.

How much does voice mode cost to use?

Voice mode requires your own OpenAI API key. OpenAI bills that usage separately from the Veelops subscription, so the exact cost depends on the models used, the length of the session, audio activity, and how much the assistant speaks or processes.

We actively optimize model usage and session behavior with the goal of bringing a full long voice coding session down to less than a dollar in OpenAI API cost. You should still set budgets, usage limits, and alerts for the API key inside the OpenAI platform before using voice mode heavily.

Is Veelops just a remote terminal?

No. The mobile terminal is the foundation, but the product is built around voice-first control for coding CLIs running in your own terminal. You can still drop into the full terminal when exact control matters.

Which coding CLIs work with Veelops?

Veelops is designed for terminal-based coding tools, including OpenAI Codex, Claude Code, Gemini CLI, OpenCode, tmux, and normal shell workflows. If the tool runs in your terminal, Veelops can usually control the session around it.

Setup

Do I need SSH, exposed ports, or a VPN?

No. The normal workflow connects through the Veelops relay using encrypted transport. You do not need to expose a port on your machine, create an SSH tunnel, or configure a VPN.

Do I need an account?

No account is required for encrypted device pairing. You install the agent, scan the pairing QR code from the mobile app, and the paired devices use their own keys to connect.

Where does the Veelops Agent CLI run?

The agent runs locally beside your code on macOS, Linux, servers, or WSL2-style environments. It manages terminal sessions, shell access, tmux-backed work, and the encrypted connection to the mobile app.

What happens if my phone disconnects?

Your work keeps running on the machine where the agent is installed. tmux-backed sessions can stay alive, and the mobile app can reconnect and rejoin the active workstream later.

Voice Mode

What can I say to Veelops?

You can ask for reports, send the next coding instruction, start or stop work, approve a path, switch sessions, or ask the active coding CLI to run tests, explain output, fix a bug, or continue a task.

What is Execution mode?

Execution mode is for flow. It treats spoken input as the next terminal or coding CLI instruction, with controls for reports, cancellation, and exiting. Conversational mode is better when you want inspection, summaries, and decisions before sending something into the terminal.

Can Veelops read reports aloud instead of showing me raw logs?

Yes. Reports are one of the main reasons Veelops exists. You can ask what happened and get the useful state of the session without scanning raw terminal output on a small screen.

Security

Can Veelops see my code, commands, or terminal output?

Terminal transport is end-to-end encrypted between your phone and the Veelops Agent CLI running on your machine. The relay routes encrypted frames but cannot read your commands, terminal output, code, or coding CLI responses.

What does the relay know?

The relay is content-blind. It needs enough routing metadata to connect paired devices, but the terminal payload stays encrypted and unreadable to the relay.

Which encryption algorithms does Veelops use?

Veelops uses the Noise IK protocol for the encrypted channel handshake, mutual authentication, and forward secrecy. Terminal payloads use ChaCha20-Poly1305 authenticated encryption, with the streaming transport described as XChaCha20-Poly1305 secretstream in the terminal path.

Can I revoke a paired device?

Yes. Veelops is built around explicit device pairing and device allowlisting, so paired devices can be removed when you no longer want them to connect.

Pricing and Limits

What is included in the free plan?

The free plan lets you pair a machine, use the encrypted mobile terminal workflow, and keep up to 3 active sessions. Voice mode is not included in the free plan.

What is included in Unlimited Vibes?

Unlimited Vibes includes unlimited active sessions plus voice mode, reports, Execution mode, and the full mobile workflow. Store pricing can vary by country, so the website uses "from" pricing.

Is OpenAI API usage included in the Veelops subscription?

No. OpenAI API usage is billed separately by OpenAI and is not part of the Veelops subscription or app store purchase. You provide the API key and remain responsible for budgets, limits, and usage on that key.

Can I run multiple coding sessions?

Yes. Veelops is designed around multiple sessions and workstreams, so different repos, folders, shells, or coding CLIs can run in parallel and be rejoined from the phone.