Installation

Quick Install (Recommended)

The easiest way to install is with our install script:

curl -sSL https://raw.githubusercontent.com/zach-snell/obx/main/install.sh | bash

This automatically:

• Detects your OS and architecture
• Downloads the correct binary
• Installs to /usr/local/bin

No sudo? Install to your home directory:

curl -sSL https://raw.githubusercontent.com/zach-snell/obx/main/install.sh | bash -s -- --user

This installs to ~/.local/bin instead.

Manual Download

macOS (Apple Silicon)

curl -sSL https://github.com/zach-snell/obx/releases/latest/download/obx-darwin-arm64 -o obx
chmod +x obx
sudo mv obx /usr/local/bin/

macOS (Intel)

curl -sSL https://github.com/zach-snell/obx/releases/latest/download/obx-darwin-amd64 -o obx
chmod +x obx
sudo mv obx /usr/local/bin/

Linux (x64)

curl -sSL https://github.com/zach-snell/obx/releases/latest/download/obx-linux-amd64 -o obx
chmod +x obx
sudo mv obx /usr/local/bin/

Linux (ARM)

curl -sSL https://github.com/zach-snell/obx/releases/latest/download/obx-linux-arm64 -o obx
chmod +x obx
sudo mv obx /usr/local/bin/

Windows

Download obx-windows-amd64.exe from the releases page.

Go Install

If you have Go installed:

go install github.com/zach-snell/obx/cmd/obx@latest
mv $(go env GOPATH)/bin/server $(go env GOPATH)/bin/obx

Build from Source

git clone https://github.com/zach-snell/obx.git
cd obx
go build -o obx ./cmd/obx

Upgrading

Just run the install script again:

curl -sSL https://raw.githubusercontent.com/zach-snell/obx/main/install.sh | bash

It always fetches the latest version.

Verify Installation

obx --help

You should see usage information.