TermLink

Docs / Install / macOS

Install on macOS

One executable in a .tar.gz. No installer, no background service, nothing added to your login items.

1. Pick the right build

Apple Silicon (M1 and later) takes arm64. Intel Macs take amd64. If you are not sure, ask the machine:

uname -m
# arm64   → termlink-macos-arm64.tar.gz
# x86_64  → termlink-macos-amd64.tar.gz

Get it from the download page, which always points at the current release.

2. Verify and unpack

Every release ships a SHA256SUMS file. Checking against it takes one command and tells you the download arrived intact.

shasum -a 256 termlink-macos-arm64.tar.gz
# compare with the line in SHA256SUMS

tar -xzf termlink-macos-arm64.tar.gz

3. macOS will refuse to run it the first time

This is expected, and worth saying plainly: the binary is not code-signed or notarised. If you downloaded it through a browser, macOS attaches a quarantine flag and Gatekeeper blocks the first run — usually with a dialog saying the developer cannot be verified.

Two ways past it. Either clear the quarantine flag:

xattr -d com.apple.quarantine ./termlink

Or open System Settings → Privacy & Security, find the blocked item near the bottom, and choose Open Anyway.

Downloading with curl instead of a browser avoids the flag entirely, because nothing marks the file as quarantined. If you would rather check what you are running before you run it, the relay it talks to is published alongside every release, and the security page sets out what it can and cannot see.

4. Put it somewhere on PATH

Optional, but it saves typing ./termlink forever.

chmod +x termlink
sudo mv termlink /usr/local/bin/

5. Sign in and share a terminal

termlink login     # opens Google sign-in
termlink           # share this terminal
termlink whoami    # which account am I on?

To share a terminal that already has Claude Code running in it, use termlink claude instead.

Leave that terminal open. TermLink is not a background service, so the machine goes offline when the process stops. To keep it alive after you disconnect from SSH, start it inside tmux or screen.

Keeping it current

termlink update pulls and verifies the latest release in place, so you do not repeat the steps above.

Something not working? Troubleshooting lists what each message means. Installing somewhere else — Linux or Windows.