Install

The simplest install path is one shell command:

terminal

/bin/sh -c "$(curl -fsSL https://downloads.contextbridge.ai/cli/install.sh)"

The script picks up Homebrew if you have it, otherwise downloads the release tarball into $HOME/.local/bin. After the binary lands, it runs contextbridge install interactively to add review hooks to any supported AI coding harness it detects. The /bin/sh -c "$(curl ...)" form preserves terminal input so you stay in control of those prompts.

See Manual install below if you’d rather drive it yourself.

Manual install

Two steps either way: get the binary on your PATH, then run contextbridge install to wire up the hooks.

Step 1a: Homebrew (preferred)

terminal

brew install contextbridge/tap/cli

Step 1b: Tarball

If Homebrew isn’t an option, grab the latest release tarball directly.

macOS Apple Silicon

terminal

curl -fsSL "https://downloads.contextbridge.ai/cli/latest/contextbridge_latest_darwin_arm64.tar.gz" -o contextbridge.tar.gz
curl -fsSL "https://downloads.contextbridge.ai/cli/latest/checksums.txt" | grep "contextbridge_latest_darwin_arm64.tar.gz" | shasum -a 256 -c -
tar -xzf contextbridge.tar.gz
mv contextbridge ~/.local/bin/  # or anywhere on your $PATH

macOS Intel

terminal

curl -fsSL "https://downloads.contextbridge.ai/cli/latest/contextbridge_latest_darwin_amd64.tar.gz" -o contextbridge.tar.gz
curl -fsSL "https://downloads.contextbridge.ai/cli/latest/checksums.txt" | grep "contextbridge_latest_darwin_amd64.tar.gz" | shasum -a 256 -c -
tar -xzf contextbridge.tar.gz
mv contextbridge ~/.local/bin/  # or anywhere on your $PATH

Linux arm64

terminal

curl -fsSL "https://downloads.contextbridge.ai/cli/latest/contextbridge_latest_linux_arm64.tar.gz" -o contextbridge.tar.gz
curl -fsSL "https://downloads.contextbridge.ai/cli/latest/checksums.txt" | grep "contextbridge_latest_linux_arm64.tar.gz" | shasum -a 256 -c -
tar -xzf contextbridge.tar.gz
mv contextbridge ~/.local/bin/  # or anywhere on your $PATH

Linux amd64

terminal

curl -fsSL "https://downloads.contextbridge.ai/cli/latest/contextbridge_latest_linux_amd64.tar.gz" -o contextbridge.tar.gz
curl -fsSL "https://downloads.contextbridge.ai/cli/latest/checksums.txt" | grep "contextbridge_latest_linux_amd64.tar.gz" | shasum -a 256 -c -
tar -xzf contextbridge.tar.gz
mv contextbridge ~/.local/bin/  # or anywhere on your $PATH

Step 2: Wire up the hooks

terminal

contextbridge install

This detects every supported AI coding harness on your machine and adds the review hooks. The curl one-liner runs this for you; both manual paths leave it as a separate step. See the installer reference for flags and per-harness targeting.

Verify

terminal

contextbridge --version
contextbridge install status

install status reports which supported harnesses were detected and which currently have PlanBridge wired in.

Installer options

The install script accepts flags after --:

Flag	Env var	What it does
--channel alpha	CB_CHANNEL	Install from the alpha release channel instead of stable.
--version v0.1.0	CB_VERSION	Pin to a specific tagged release. Requires --no-brew.
--no-brew	CB_NO_BREW=1	Skip Homebrew even if available; fall through to the tarball path.
--bin-dir <dir>	CB_INSTALL_DIR	Override the tarball install dir (default $HOME/.local/bin). Requires --no-brew.
--no-configure	CB_SKIP_CONFIGURE=1	Skip the post-install contextbridge install step. Useful in CI.

Pass flags after --:

terminal

/bin/sh -c "$(curl -fsSL https://downloads.contextbridge.ai/cli/install.sh)" -- --channel alpha

Update

terminal

contextbridge update

Set CONTEXTBRIDGE_UPDATE_CHECK_DISABLED=1 to silence the periodic update check.

Uninstall

terminal

contextbridge uninstall

Removes PlanBridge wiring from every harness. After that, remove the binary itself with the same package manager that installed it (Homebrew, or rm $HOME/.local/bin/contextbridge).