Support
We read every message.
Need a hand with TermBridge? Most answers are below. If you're still stuck, email us and we'll get back to you.
Include your macOS version, device model, and what you were doing — it helps us help you faster.
Getting started
- Install the Mac app — download the
.dmg, drag TermBridge to Applications, and launch it once. It lives in your menu bar. - Pair your phone — open the menu-bar popover, then scan the QR code with the TermBridge iOS app. Approve the fingerprint on your Mac.
- Attach — your live terminals appear on your phone. Tap one to attach.
Troubleshooting
My phone says "connecting" forever
Make sure the TermBridge menu-bar app is running on your Mac (look for the icon in your menu bar) and that the status shows it's connected to the relay. If your Mac just woke from sleep, give it a few seconds to reconnect. Quitting and relaunching the menu-bar app re-establishes the connection.
No terminals show up
TermBridge attaches at the shell layer. Open a new terminal window (or a new tab in iTerm2 / VS Code / Zed) after installing — existing shells started before install won't be hooked until you open a fresh one.
Pairing fails or the fingerprint doesn't match
Re-open the QR from the menu-bar popover and scan again. If a fingerprint mismatch appears, do not approve it — re-pair from a fresh QR. Each pairing is one-time and device-specific.
How do I uninstall?
Quit the menu-bar app, then drag TermBridge.app from Applications to the Trash. The shell hook fails safe and removes itself; if you want to scrub it manually, the agent ships with an uninstaller that removes the shell snippet and pairing keys.
Common questions
Is this just an SSH client?
No. SSH clients open a brand-new login shell on a fixed address. TermBridge hooks the shell layer so it mirrors the terminals you're already in — including the ones embedded in VS Code, Zed and Cursor — and never needs an open port, a public IP, or a port-forward.
How does it reach my Mac without opening a port?
Your Mac holds a single outbound encrypted connection to a relay. Your phone connects to the same relay and the two are paired into a private room. There is no inbound port on your Mac, so nothing new is exposed to the internet.
Can the relay read my terminal?
No. Everything is end-to-end encrypted with X25519 + AES-256-GCM and a fresh ephemeral key per session. The relay routes sealed frames only — it never holds a key and never sees plaintext.
What does it touch on my Mac?
A guarded snippet re-execs your interactive shell through an agent-owned PTY. It always fails safe — a missing binary or bad state can never lock you out of a terminal — and you can remove it any time with the bundled uninstaller.
Which terminals work?
All of them. Because the hook is at the shell layer, iTerm2, Terminal.app, the VS Code / Zed / Cursor integrated terminals, and tmux sessions all show up the same way.
Is it on the App Store yet?
The iOS app is in TestFlight beta now and the Mac app ships as a direct .dmg download. A public App Store release is on the way — join the beta to get in early.
Still need help?
Email clovinyxllc@gmail.com and we'll sort it out.