Known limitations

We’d rather you know the edges up front. Here’s where TermBridge currently stops.

Shell support

• zsh only. The shell hook is zsh-specific. zsh is the default interactive shell on macOS (since Catalina), so most setups work out of the box — but if your login shell is bash or fish, TermBridge won’t wrap your shells. See Installation.

Platform support

• Phone side: iPhone and iPad. Android is coming soon.
• Shell side: zsh only. Bash and fish shells are not wrapped yet.
• Mac side requires macOS 13 (Ventura) or later.

Your Mac must be reachable

• The agent holds a single outbound connection to the relay. If your Mac sleeps or goes offline, its shells stop being reachable until it wakes. For long unattended runs, keep the Mac awake and plugged in.

Buffer caps

• Scrollback replay is 256 KiB per shell. When you re-attach, you get the most recent 256 KiB of output replayed — older output beyond that isn’t retained for replay.
• Clipboard sync is capped at 256 KiB per item. Larger payloads won’t sync.

Free-plan caps

• Free is limited to 1 Mac, 1 active terminal, 10 agent answers, 3 local server previews, and 3 uses each of voice, file send, file browse and clipboard sync. Pro removes these. See Plans & limits.

Next

Questions left over? The FAQ has quick answers.