FAQ
Quick answers to real questions.
Straight, practical answers to what people actually ask us — no fluff. Can't find yours? Reach out via Support.
Panes look narrow on my phone with a big crew / lots of empty space — why?
The phone renders exactly the tmux grid your Mac terminal hands it — nothing more, nothing less. If your Mac terminal window uses a large font, tmux fits fewer columns into it, and Termio faithfully shows that narrower content with room around it. Shrink your Mac terminal's font size (e.g. Cmd+- in Ghostty or Terminal.app) and tmux immediately gains columns in the same window space; each pane now carries more content, so Termio renders it dense and full-width at whatever font size you chose. This isn't a phone-side setting — the source of truth is always your Mac's tmux grid.
macOS asks me to re-grant permissions after every update.
Fixed in 1.1.57 and later — the daemon's self-updater now swaps its binary atomically instead of overwriting it in place, so Accessibility and Screen Recording grants now survive updates. If you were affected by an earlier build, there's a one-time cleanup: open System Settings → Privacy & Security → Accessibility (and Screen Recording, if you use recording features), find Termio Status in the list, and toggle it off then back on — or remove it with the “-” button and relaunch Termio Status so macOS re-prompts you. If a permission is ever lost again, the menu bar app now shows a guided banner with a direct “Open Settings” button, so you don't have to hunt for the right pane yourself.
How do I pair my phone with my Mac?
On your Mac, open Termio Status from the menu bar and choose “Pair with Code…” — it shows a QR code plus an 8-character fallback code. On your phone, open Termio and tap Scan QR (point it at your Mac's screen) or Type Code and enter the 8 characters manually. Your Mac appears in the app the moment pairing completes, and its tmux panes show up automatically — no separate setup step.
Is my terminal content private? What does crash reporting actually send?
Yes — the relay is a router, not a recorder: it never stores your terminal output, pane buffers, prompts, or agent responses. Crash reporting (Settings → “Share Crash Reports” on Mac, “Share anonymous diagnostics” on Android) is an opt-in toggle that sends only scrubbed diagnostics — app/OS version, the error name and stack trace, and, on Mac, the last ~50 lines of the daemon's own log with your home directory and username stripped before anything is written or uploaded. It never includes terminal or pane content. Turn the toggle off any time to stop collection and upload immediately.
How do I update the Mac app, and where are the release notes?
Termio Status checks for updates automatically and shows your current build right in the menu. Click “Check for Updates” any time to force a check, or “Download & Install” when a new version is ready — no separate download needed. Full release history for iOS, macOS, and Android lives at /changelog, the same catalog the app itself checks against.
What crew sizes are supported?
A crew supports 3 to 10 panes total — 1 manager plus 2 to 9 workers. This cap is enforced consistently everywhere a crew can grow (crew creation, add-worker, and the tmux-side crew tooling), so you'll see the same limit no matter which surface you use.
Still have a question?
Email [email protected] — we read every message and typically reply within 2 business days.