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.
05Preview your mobile app PRO
Building a React Native / Expo app? Termixa can run it natively on your phone, straight from the dev server on your computer — no cable, no TestFlight, no same-network requirement.
In a Termixa workspace: start your app's dev server — right from the terminal on your phone, no need to be at your desk:
❯ cd ~/my-app ❯ npx expo start
Then: open ☰ → Preview Mobile App. Add Metro's port (usually 8081) if it isn't listed yet.
Tap the port. The JS bundle streams over the encrypted tunnel and your app boots natively on the phone — a loading screen shows the progress.
Iterate: save a file on the computer and the preview reloads with your changes automatically. Tap ✕ Preview to drop back into the terminal.
Good to know: previews run your project's JavaScript on Termixa's built-in Expo SDK 56 runtime. Popular libraries are bundled — React Navigation, reanimated, gesture-handler, SVG, expo-image, fonts, gradients, haptics, async-storage and more — but projects that require their own custom native modules won't load. The first load takes a few seconds; iterations after that are instant. Debugging is built in: your app's console logs stream into the workspace running npx expo start, and warnings/errors show inside the preview itself.
06Linux 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.
07Sessions & 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.
08Settings & 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, 1-hour 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).
Do I need to deploy my web app — or expose it to the internet — to view it on my phone?
No. Whitelist the port and the page travels through the same encrypted peer-to-peer tunnel as your terminal. There's no public URL, no tunnel service, and nothing for anyone else to reach — only your paired phone can open it.
My web app loads on the phone, but its data is missing. Why?
Your frontend is probably calling an API on a second port (say localhost:8000). Enable that port too — Termixa mirrors every whitelisted port on the phone, so cross-port API calls work exactly like they do on your computer.
Which mobile apps can I preview on my phone?
React Native / Expo projects on Expo SDK 56 that use Termixa's bundled native module set (React Navigation, reanimated, gesture-handler, SVG, expo-image and more). Projects that require their own custom native modules won't load. Mobile App Preview is a Pro feature — and included in every 7-day trial.
Is the mobile preview a video stream of my computer's simulator?
No — it's the real thing. Your app's JavaScript bundle streams to the phone once and then runs natively on the device, with real touch, animations, and performance. Save a file on the computer and the preview reloads with your changes automatically.
Do I need an extra AI subscription or Termixa credits to use AI?
No. Termixa doesn't host or resell AI — it connects you to the tools already on your computer, using the accounts you already have. If Claude Code, Gemini CLI, Codex, or Aider runs in your terminal today, it runs in Termixa at no extra cost.
Can I answer my AI agent's questions and approve its plans from the phone?
Yes — that's the core workflow. Everything the agent prints streams live to your phone, and the smart key row (TAB, ESC, CTRL, arrows, ENTER) handles every interactive menu. Kick off a task, leave your desk, and reply the moment it asks.
Does my AI agent stop when I lock my phone?
No. The agent runs on your computer, not your phone — it keeps working while you're away. Reopen Termixa, tap Restore Previous Session, and the full scrollback of what happened comes right back.
Ready to try it?
Get the iPhone app, install the Connector on your computer, scan — that's it.