You drive everything from your iPhone; the desktop Connector just links the app to a machine. Here's the whole workflow, in the order you'll actually need it.
01Get connected
Termixa is the app on your iPhone — that's where you work. The desktop Connector is a lightweight helper you install once on each computer you want to reach; it shows a pairing QR, then gets out of the way.
On your iPhone: install Termixa from the App Store and sign in with Apple or Google. Your 7-day free trial starts automatically — no card needed.
On the computer you want to reach:download the Termixa Connector and open it. A pairing QR code appears — that's its whole job.
Pair: in the app, tap Scan QR to Connect and point the camera at the computer's screen. A live terminal opens on your phone.
Tip: keep the Connector running while you're away — it's the bridge your phone reaches through.
02Use the terminal
Type & run: enter commands in the input bar. Output streams live from your computer.
Special keys: tap the terminal icon to reveal TABENTERCTRL+C↑↓ESCCTRLSHIFT — everything interactive CLIs and AI menus need.
Tab completion: start typing a path and hit TAB — completion comes from your real shell.
Multiple workspaces: tap ＋ for up to 6 tabs. Long-press a tab to rename it ("agent", "server", "git"…).
Quick Commands: tap the Menu pill for one-tap commands; manage your own via ☰ → Manage Commands.
03Run an AI agent
Start your agent exactly as you would at your desk — move into your project, then launch whichever agent you use:
# Claude Code ❯ cd ~/my-project ❯ claude
# Gemini CLI ❯ cd ~/my-project ❯ gemini
# OpenAI Codex ❯ cd ~/my-project ❯ codex
# Aider ❯ cd ~/my-project ❯ aider
Any other CLI tool works the same way — if it runs in your terminal, it runs in Termixa. Everything the agent prints appears on your phone, and every approval or answer it needs is one tap away. Run it in one workspace, keep logs or git in another.
04Preview local web apps
On the Connector, open the Ports tab and allow a port (e.g. 3000). Only whitelisted ports are ever reachable.
On your phone, open ☰ → View Local Web App and pick the port.
The page renders on your phone through the same encrypted connection — as if your phone were on your computer's localhost.
Here's what it looks like in the app — every whitelisted port shows up, one tap away:
Local Web Apps
Active ports on the Connector
localhost:3000Open in viewer
›
localhost:8080Open in viewer
›
Open a port
e.g. 5173+
Tip: enable BOTH your frontend and backend API ports on the Connector so data loads.
05Linux servers (headless)
No desktop environment? Termixa runs entirely in the terminal and prints the pairing QR right into your SSH session:
# download the server binary from the downloads page, then: chmod +x termixa-headless ./termixa-headless --allow-ports 3000,8080
The QR appears as ASCII art — scan it with the app exactly like the Connector's on-screen QR.
Keep it running with tmux/screen, or as a systemd service.
A single static binary — nothing to install, works on any modern x86-64 Linux.
06Sessions & reconnecting
Pick up where you left off: tap Restore Previous Session — your workspaces and their scrollback come right back.
Start fresh:Scan QR For New Connection ends the old session and rotates the Connector's QR.
End it: the red power button closes the session on both sides instantly.
07Settings & account
Session timeout: ☰ → Settings — from 30 minutes up to Never (Trial/Pro).
Devices: Profile → Devices — see every phone on your account and remove one to free a slot.
Subscription: Profile → Manage Subscription — upgrade, switch plans, or cancel, right inside the app.
FAQ
Do both devices need to be on the same Wi-Fi?
No. Any networks work — home, office, 5G, hotel. Termixa finds the path automatically.
Does my code or terminal output go through Termixa's servers?
No. Sessions are peer-to-peer and end-to-end encrypted. Our servers only introduce your devices and manage your subscription. Even when an encrypted relay assists a difficult network, it cannot read your data.
What happens when my trial ends?
You keep the Free plan (1 workspace, 1 port, 30-minute sessions) — or upgrade to Pro for the full experience.
Which platforms are supported?
The app runs on iPhone — Android is on the roadmap. The Connector runs on macOS, Windows, and Linux (GUI + a headless server binary).
Ready to try it?
Get the iPhone app, install the Connector on your computer, scan — that's it.