Installation

Terox is a single static binary that ships for Linux, macOS, and Windows on both amd64 and arm64. Pick whichever install method matches your platform — they all give you the same binary.

With Homebrew (macOS and Linux)

The fastest install on macOS and Linux is through the weburz/tap Homebrew tap:

brew install weburz/tap/terox

That installs terox into the standard Homebrew prefix and adds it to your PATH automatically.

With Scoop (Windows)

On Windows, install through the weburz/scoop-bucket Scoop bucket:

scoop bucket add weburz https://github.com/weburz/scoop-bucket
scoop install weburz/terox

If you do not have Scoop yet, follow the one-line install at scoop.sh first.

Direct binary download

Every release attaches a prebuilt archive for each supported platform to the GitHub releases page. A checksums.txt next to the archives lets you verify the download.

Pick the archive that matches your OS and architecture, for example:

# Linux on amd64
curl -L -o terox.tar.gz \
  https://github.com/weburz/terox/releases/latest/download/terox_0.1.2_linux_amd64.tar.gz
tar -xzf terox.tar.gz
sudo mv terox /usr/local/bin/

On Windows the archive is a .zip containing terox.exe; extract it and move the executable somewhere on your PATH.

With Go (go install)

If you already have Go 1.23 or newer installed, you can install Terox directly from source:

go install github.com/weburz/terox@latest

Make sure the binary is on your PATH

go install writes the binary to $(go env GOBIN) if GOBIN is set, or $(go env GOPATH)/bin otherwise. On a typical Linux or macOS setup that's ~/go/bin. If that directory is not on your PATH, the terox command will not be found.

Add it permanently to your shell config:

# bash
echo 'export PATH="$PATH:$HOME/go/bin"' >> ~/.bashrc
source ~/.bashrc

# zsh
echo 'export PATH="$PATH:$HOME/go/bin"' >> ~/.zshrc
source ~/.zshrc

Building from source

Clone the repository and build with the included Taskfile:

git clone https://github.com/weburz/terox.git
cd terox
task build

The binary will be written to ./bin/terox. Move it onto your PATH (for example sudo mv ./bin/terox /usr/local/bin/) or invoke it directly.

If you do not have Task installed, go build . produces the same binary without the embedded version metadata.

Verify the install

Whichever method you used, confirm it worked:

which terox
terox version

terox version should print the version number, commit hash, and build date for the binary you just installed.

Updating