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.

Contact: [email protected]
Include your macOS version, device model, and what you were doing. It helps us help you faster.

Getting started

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

Open Pair a new device in the Mac window 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?

Run the uninstaller (see Uninstalling), then drag TermBridge.app from Applications to the Trash. The uninstaller removes the shell hook block and the pairing keys.

Common questions

Is this just an SSH client?

No. An SSH client opens a new login shell on an address you reach over the network. TermBridge shows the shells you already have open, including the ones inside VS Code, Zed and Cursor. It needs no open port and no public address.

How does it reach my Mac without opening a port?

Your Mac keeps one outbound, encrypted connection to a relay. Your phone connects to the same relay and the two are paired into a private room. Nothing listens on your Mac. The relay cannot read the traffic.

Can I answer Claude Code from my phone?

Yes. When Claude Code stops on a permission prompt or a question, your phone shows it under Agents and sends a push. Answer with Allow, Always allow, Deny, or Deny with a note, or approve from the notification. The Mac app sets up the Claude Code hooks for you.

Can I open my localhost on my phone?

Yes. The Local servers list shows every dev server listening on your Mac. Tap one and it opens on your phone over the same encrypted link. Debuggers, Docker's API and databases on their usual ports are never exposed.

What does it change on my Mac?

A small block in ~/.zshrc that starts each new interactive zsh through the agent, plus a background agent. If the agent is missing or broken, your shell starts as normal. The uninstaller removes both.

What does Free include?

One Mac, one active terminal, 10 agent answers, 3 local server previews, and 3 uses each of voice, file send, file browse and clipboard. Pro removes the limits.

Does it work on Android?

Android is coming soon. Today TermBridge is on iPhone and iPad.

Which terminals work?

Any terminal app that runs zsh: iTerm2, Terminal.app, the terminals inside VS Code, Zed and Cursor, and tmux. Bash and fish shells are not wrapped yet.

Still need help?

Email [email protected] and we'll sort it out.