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 from the selected Mac terminal — nothing more, nothing less. If that 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 the selected Mac terminal's font size (e.g. Cmd+- in Ghostty or Terminal.app) and tmux immediately gains columns in the same window space; switch machines in the picker when you need a different target. This isn't a phone-side setting — the source of truth is always the selected 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 Mixcrew Desktop in the list, and toggle it off then back on — or remove it with the “-” button and relaunch Mixcrew Desktop 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?
The first Mac on your account registers automatically when you sign in to Termio there; no phone is required. Sign in to the same account on iOS or Android and select that Mac. To add another Mac, sign in on the new Mac and choose Enter pairing code: generate its eight-character code on an approved phone under Pair Mac, or on a trusted Mac under Devices → Get pairing code, then enter it on the new Mac. Alternatively, scan the new Mac’s pairing QR with an approved phone. Registration is separate from readiness: check the daemon connection, tmux and your chosen agent CLI, then start an agent pane. Use the machine picker to switch Macs.
First launch on the Mac seems stuck — nothing happens after I open the app.
That first launch is macOS itself, not Mixcrew Desktop — before our code ever runs, Gatekeeper checks the developer certificate hasn't been revoked, which needs a brief network round-trip. On a normal connection this is usually instant; on a restrictive network, captive portal, or a DNS/firewall setup that blocks or intercepts Apple's certificate-check servers, macOS may wait out that check with no visible progress (no spinner, no dock bounce) rather than failing fast. It isn't specific to Mixcrew and isn't something an app can shorten or skip: the wait happens before any app code, ours or anyone else's, gets to run. If it never opens, try a different network (e.g. phone hotspot) for the first launch only — after that, macOS remembers the app and every later launch is instant.
Is my terminal content private? What does crash reporting actually send?
Termio uses HTTPS/WSS, not end-to-end encryption. Live terminal streams stay in a temporary memory buffer; Agent Inbox messages and Board fields are persisted. iOS MetricKit and Android crash reports are queued and uploaded automatically through a real relay connection, independently of the mobile anonymous-diagnostics preference. The Mac Share Crash Reports setting controls Mac reporting; optional iOS Sentry reporting follows Share anonymous diagnostics when Sentry is configured. Both settings default to enabled. Reports can include app/OS/device metadata, stack traces and, on Mac, daemon log excerpts. Mac reporting scrubs home-directory and username strings, but free text may still contain sensitive details. See the privacy policy for the full inventory and retention limits.
How do I update the Mac app, and where are the release notes?
Mixcrew Desktop checks for updates automatically on each Mac and shows the current build right in that Mac's 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 2 to 10 panes total — 1 manager plus 1 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 support@termio.xyz — we read every message and typically reply within 2 business days.