Installation

Installing TermBridge takes about two minutes and creates no accounts.

Requirements

• Mac: macOS 13 (Ventura) or later.
• iPhone / iPad: a recent version of iOS / iPadOS.
• Both devices need internet access — but they do not need to be on the same network.

1. Install the Mac menu-bar app

1. Download the app: downloads.termbridge.clovinyx.io/TermBridge.dmg
2. Open the .dmg and drag TermBridge.app to your Applications folder.
3. Launch it once. It lives in your menu bar (look for the TermBridge icon near the clock).

On first launch, the app installs two small things:

• A background agent that runs under launchd and owns your terminal sessions.
• A shell hook — a small marked block added to your ~/.zshrc (between # >>> termbridge >>> and # <<< termbridge <<<) that sources the guarded hook. Your ~/.zshrc is backed up first.

TermBridge asks your permission before touching ~/.zshrc and backs it up first — it never edits your shell config silently. Both changes are fully reversible (see Uninstalling). The app is Developer-ID signed and notarized by Apple, so it launches without security warnings.

Using bash or fish? The hook is zsh-specific, so TermBridge won’t silently append to an unused ~/.zshrc. If your login shell isn’t zsh, the app lets you know — switch your interactive shell to zsh (the macOS default since Catalina) to use TermBridge.

2. Get the iOS app

Download TermBridge from the App Store. It’s a universal app — the same download runs on iPhone and iPad.

3. Open a fresh terminal

The shell hook only applies to new shells. Open a new terminal window (or run exec zsh) so your shell re-execs through the agent. Existing windows opened before install keep running normally; they just won’t appear in TermBridge until you reopen them.

Next

You’re installed. Now pair your phone to your Mac.