Everything you need to get unstuck.

Starting on your Mac

1. Download TermioStatus.dmg from the homepage (or run the one-line installer it links to), open it, drag Termio Status to Applications.
2. Open Termio Status from the menu bar (a small cloud icon), choose "Pair with Code…"
3. Open the iPhone app, tap Scan QRand point it at your Mac's screen — or tap Type code and enter the 8-character code shown on your Mac.
4. Your Mac appears in the app as soon as pairing completes. If tmux or an agent CLI (Claude Code / Codex / Cursor) isn't installed yet, the app tells you exactly which one is missing — see Setting Up Your Agents below.

Starting on your iPhone (no Mac app yet)

1. The very first screen you see is Pair a Mac. Tap "Don't have the Mac app yet? Get it here"— this opens the download page on the same domain you're already using.
2. Install the Mac client (steps above), then come back to this screen.
3. Scan the QR code your Mac shows, or type the 8-character code manually.

The Mac-side command, if you prefer a terminal

Advanced users can pair directly from a terminal instead of the menu-bar UI:

termio daemon pair --code <token> --relay-url <url> [--force] [--insecure] [--machine-name <name>]

The code and relay URL come from the QR/pairing screen on the phone app.

• Claude Code — binary claude
• Codex — binary codex
• Cursor — binary agent(Cursor's CLI is named "agent", not "cursor")

"CLI not found"

If Termio can't find an agent's CLI on your Mac, it shows exactly which binary it looked for and where. Fix it one of two ways:

1. Install the agent normally, then restart the daemon from the menu bar.
2. Already installed somewhere non-standard? Add an override to ~/.termio/agent-cli.json:

   {"agents":[{"id":"claude","binary":"/absolute/path/to/claude"}]}

   then restart the daemon.

Pane

One live terminal session Termio is watching — the atomic unit you switch between and watch stream in the app.

Crew

A group of worker panes working together — one manager plus one or more workers, each running its own agent CLI. Create one from the "+" button, then add workers; if a worker's agent CLI isn't installed, you'll see the "CLI not found" guidance from above.

My Mac is already paired to another account — what do I do?

This is the ALREADY_PAIRED_OTHER diagnosis — see Pairing Troubleshooting above. Run termio daemon pair --rebind --code <code> --relay-url <url> to move the Mac to your account.

Codex is sending too many messages / the visible terminal area feels too small.

This was a known bug (rapid-fire Codex output overwhelming the live view) and is fixed as of the latest Mac client and iOS build. Update both and it should be resolved — if it isn't, email us.

A markdown (.md) file won't preview in the app.

Fixed — update to the latest iOS build. Markdown files now render inline instead of falling back to a generic file icon.

My terminal seems frozen or stuck after clicking or scrolling — how do I recover?

This is almost always tmux's own scrollback view ("copy mode"), not a crash — a mouse scroll or an accidental keypress can drop a pane into it, and while it's active the pane looks unresponsive: typing doesn't reach your agent, or the bottom line keeps asking you to type something that never seems to confirm. Nothing is lost — your session and its output are still there. Try these, in order, from your Mac's keyboard (in the actual Ghostty window, not from the phone):

1. Press q — exits tmux's scrollback/copy mode.
2. Press Esc — exits copy mode or cancels a stuck bottom-line prompt.
3. Press Ctrl+C — cancels most stuck prompts if the above don't register.
4. Click into the pane once, then repeat step 1–3 — sometimes focus needs to land on the right pane first.
5. Close just the affected Ghostty window/tab and reopen Termio's menu-bar item — your agent keeps running on the Mac either way, so nothing is interrupted.

Quitting Ghostty entirely should not be necessary — if steps 1–4 don't clear it for you, email [email protected] with what you clicked/typed right before it happened — that detail helps us track down the exact trigger.

What does "Install Recommended Environment" do in the menu-bar app?

It sets up fleetmux — our free, open-source terminal distribution — on your Mac: the Ghostty terminal, the fish shell, the Starship prompt, and a tuned tmux config, all in one click. You'll see exactly what it plans to install before anything runs, and you can uncheck fish or Ghostty individually if you only want the tmux/Starship core. Termio doesn't require any of this — it's an optional shortcut to the setup we personally recommend. fleetmux itself works standalone with any terminal app, agent, or none at all — install it directly with curl if you'd rather not use the Mac app; see the key-binding cheat sheet once it's installed.

Does Termio store my terminal output?

No — the relay is a router, not a database. It never stores terminal contents (no pane output, no prompts, no responses). See the Privacy Policy for exactly what IS persisted (account info, Inbox messages).

I found a security issue, or want to report something suspicious an agent did.

Please email [email protected] with as much detail as you can — screenshots and the exact steps help us fix it fast.

Still stuck?

Visit Support or email [email protected].