Installation

Install the Betwixt CLI on macOS, Linux, or WSL to start working with distributed AI agents.

The Betwixt CLI (bx) is the primary interface for interacting with the Betwixt platform. It runs on macOS, Linux, and Windows via WSL.

Quick Install

Run the install script to download and install the latest version of bx:

curl -fsSL https://get.betwixtai.com | sh

The installer will detect your operating system and architecture, download the appropriate binary, and add it to your PATH. After you sign in, the dashboard may generate a device-specific setup or pairing command for live work.

Verify Installation

After installation, verify that bx is available:

bx --version

You should see output like bx 0.1.0 (aarch64-apple-darwin).

Review the Installer First

If you want to inspect the install flow before running it, download the script locally and review it:

curl -fsSL https://get.betwixtai.com/install.sh -o install-bx.sh
less install-bx.sh
bash install-bx.sh

The current installer downloads a matching prebuilt binary for your platform when one is available. On macOS, it falls back to building bx from the official GitLab CLI repository if a native binary is not published yet.

System Requirements

macOS 12 or later (Intel or Apple Silicon)
Linux kernel 5.4 or later (x86_64 or aarch64)
Windows via WSL2 (Ubuntu 22.04 recommended)
At least 256 MB of available disk space
An active internet connection for initial setup

Updating

To update to the latest version:

bx self-update

Next Steps

Once installed, authenticate and configure your environment to connect your LLM providers.