Install

Recommended: Install Script (Linux / macOS)

The install script downloads the latest release, verifies the SHA256 checksum, and installs to ~/.local/bin:

curl -sSL https://raw.githubusercontent.com/CameronBrooks11/super-productivity-local-gobridge/main/scripts/install.sh | bash

The script auto-detects your OS and architecture. It fails closed if the checksum does not match.

Note: This command fetches the installer from the main branch. For a pinned version, download the script from a specific release tag or use the manual install method below.

Manual Download from GitHub Releases

Download the appropriate archive for your platform from the Releases page.

Platform Matrix

Release archives are versioned, with VERSION standing for the release number (0.3.0, not v0.3.0) as listed on the Releases page. The Linux and macOS commands below fill it in with the latest release; set VERSION beforehand to install a specific one. The Windows steps have no such command, so substitute it by hand in the archive names below:

Platform	Archive
Linux x86_64	sp-local-bridge_VERSION_linux_amd64.tar.gz
Linux arm64	sp-local-bridge_VERSION_linux_arm64.tar.gz
macOS arm64 (Apple Silicon)	sp-local-bridge_VERSION_darwin_arm64.tar.gz
macOS x86_64 (Intel)	sp-local-bridge_VERSION_darwin_amd64.tar.gz
Windows x86_64	sp-local-bridge_VERSION_windows_amd64.zip
Windows arm64	sp-local-bridge_VERSION_windows_arm64.zip

Linux

# Resolve the latest release, or set VERSION=x.y.z to pin one
VERSION="${VERSION:-$(curl -sL https://api.github.com/repos/CameronBrooks11/super-productivity-local-gobridge/releases/latest | grep '"tag_name"' | sed -E 's/.*"v([^"]+)".*/\1/')}"
VERSION="${VERSION#v}"
[ -n "$VERSION" ] || echo "Could not resolve a release version; set VERSION=x.y.z and re-run." >&2

# Download archive and checksums
curl -fLO "https://github.com/CameronBrooks11/super-productivity-local-gobridge/releases/download/v${VERSION}/sp-local-bridge_${VERSION}_linux_amd64.tar.gz"
curl -fLO "https://github.com/CameronBrooks11/super-productivity-local-gobridge/releases/download/v${VERSION}/checksums.txt"

# Verify checksum
grep "sp-local-bridge_${VERSION}_linux_amd64.tar.gz" checksums.txt | sha256sum -c -

# Extract and install
tar xzf "sp-local-bridge_${VERSION}_linux_amd64.tar.gz"
chmod +x sp-local-bridge
sudo mv sp-local-bridge /usr/local/bin/

macOS

# Resolve the latest release, or set VERSION=x.y.z to pin one
VERSION="${VERSION:-$(curl -sL https://api.github.com/repos/CameronBrooks11/super-productivity-local-gobridge/releases/latest | grep '"tag_name"' | sed -E 's/.*"v([^"]+)".*/\1/')}"
VERSION="${VERSION#v}"
[ -n "$VERSION" ] || echo "Could not resolve a release version; set VERSION=x.y.z and re-run." >&2

# Download archive and checksums (adjust darwin_arm64 to darwin_amd64 for Intel Macs)
curl -fLO "https://github.com/CameronBrooks11/super-productivity-local-gobridge/releases/download/v${VERSION}/sp-local-bridge_${VERSION}_darwin_arm64.tar.gz"
curl -fLO "https://github.com/CameronBrooks11/super-productivity-local-gobridge/releases/download/v${VERSION}/checksums.txt"

# Verify checksum (macOS uses shasum instead of sha256sum)
grep "sp-local-bridge_${VERSION}_darwin_arm64.tar.gz" checksums.txt | shasum -a 256 -c -

# Extract and install
tar xzf "sp-local-bridge_${VERSION}_darwin_arm64.tar.gz"
chmod +x sp-local-bridge
sudo mv sp-local-bridge /usr/local/bin/

Windows

1. Download the .zip for your architecture from the Releases page.
2. Download checksums.txt from the same release.
3. Verify the checksum matches (PowerShell: Get-FileHash or certutil -hashfile).
4. Extract sp-local-bridge.exe.
5. Move it to a directory in your PATH, or use the full path in host configs.

From Source

Requires Go 1.23+:

go install github.com/CameronBrooks11/super-productivity-local-gobridge/cmd/sp-local-bridge@latest

INFO

go install builds without release metadata, so sp-local-bridge --version will show dev. For versioned builds, use release artifacts or clone and build with make build.

Or clone and build:

git clone https://github.com/CameronBrooks11/super-productivity-local-gobridge.git
cd super-productivity-local-gobridge
make build
# Binary: ./sp-local-bridge

Verify Installation

sp-local-bridge --version
sp-local-bridge doctor

Upgrade

Download the new release binary and replace the existing one. Host configs do not need to change unless the binary path moves.

Upgrading does not touch host configs, so a host that was configured stays configured. To confirm rather than assume:

sp-local-bridge configure --status

scripts/install.sh prints the same report at the end of an install.

Uninstall

1. Remove host configs first (while the binary is still available):

   sp-local-bridge configure --remove claude-desktop
   sp-local-bridge configure --remove vscode-copilot
   sp-local-bridge configure --remove claude-code
   sp-local-bridge configure --remove codex

2. Remove the binary:

   sudo rm /usr/local/bin/sp-local-bridge

   Backup files (.bak) are created alongside host configs during configure and can be used to restore the original state if needed.