Install the wt CLI

The wt CLI is the entry point to every WonderTwin workflow — running twins locally, scanning your project for SDKs that need twinning, subscribing to twins, and integrating twins into your application. This page covers installing the CLI itself; once it’s on your PATH, head to Running twins locally to spin up your first twin.

Install

macOS (Homebrew)

brew install wondertwin-ai/tap/wt

This single command taps wondertwin-ai/homebrew-tap and installs the wt formula. Homebrew handles updates via brew upgrade wt.

Linux (go install)

On Linux, install via the Go toolchain:

go install github.com/wondertwin-ai/wondertwin/cmd/wt@latest

The binary lands at $GOPATH/bin/wt (or $HOME/go/bin/wt if GOPATH is unset). Make sure that directory is on your PATH:

export PATH="$HOME/go/bin:$PATH"

Pre-req: Go 1.21+. If you don’t have Go installed, grab it from go.dev/dl or skip the toolchain and grab a binary directly — see the next tab.

Direct download

Pre-built binaries for macOS (Intel + Apple Silicon) and Linux are attached to every release on the wondertwin repo’s Releases page.

1. Open the latest release.

2. Download the archive matching your platform — for example, wondertwin_<version>_darwin_arm64.tar.gz for Apple Silicon Macs.

3. Extract and move the wt binary onto your PATH:

   tar -xzf wondertwin_*.tar.gz
   sudo mv wt /usr/local/bin/

Verify

wt --version

You should see the installed CLI version printed. If wt isn’t found, your PATH doesn’t include the install location — Homebrew installs to /opt/homebrew/bin (Apple Silicon) or /usr/local/bin (Intel/Linux), both of which are usually already on PATH.

What’s next

• Your first twin — declare twins in wondertwin.json, run wt up, and point your SDK at localhost. Three steps, no new framework.
• Wire your app to talk to it — the substitution pattern that lets dev/staging route through twins while production talks to real services.
• Browse the catalog — every twin we offer, by tier and category.