Install ainb

ainb publishes prebuilt release binaries for macOS (Apple Silicon) and Linux (x86_64), plus Homebrew formula and Cargo source installs.

Install with Homebrew

If you are on macOS or Linux with Homebrew installed:

brew install ainb

Quick install (curl)

The install script detects your platform and downloads the latest release binary:

curl -fsSL https://raw.githubusercontent.com/stevengonsalvez/agents-in-a-box/main/ainb-tui/install.sh | bash

The script installs to /usr/local/bin when writable, otherwise ~/.local/bin (ensure it is in your PATH).

Override the install directory or pin a version:

INSTALL_DIR=$HOME/bin VERSION=1.2.0 \
  curl -fsSL https://raw.githubusercontent.com/stevengonsalvez/agents-in-a-box/main/ainb-tui/install.sh | bash

Prebuilt binaries

Release binaries with .sha256 checksums are published on GitHub Releases:

Platform	Target Architecture	Binary
macOS (Apple Silicon)	`aarch64-apple-darwin`	`ainb`
Linux (x86_64)	`x86_64-unknown-linux-gnu`	`ainb`

Install from source (cargo)

Intel macOS and ARM64 Linux builds can be installed directly with Cargo:

cargo install --git https://github.com/stevengonsalvez/agents-in-a-box --branch main ainb

Or build locally from a repository clone:

git clone https://github.com/stevengonsalvez/agents-in-a-box
cd agents-in-a-box/ainb-tui
cargo build --release   # binary output at target/release/ainb

Windows support

Windows is supported via WSL2 (Windows Subsystem for Linux). Open your WSL2 terminal (Ubuntu or Debian recommended) and follow the Linux instructions above.

Verify the install

Check the version and verify that system dependencies (git, tmux, and an agent CLI) are ready:

ainb --version
ainb init --check

Update

If installed with Homebrew:

brew upgrade ainb

If installed with the curl script, re-run the install script to fetch the latest binary:

curl -fsSL https://raw.githubusercontent.com/stevengonsalvez/agents-in-a-box/main/ainb-tui/install.sh | bash

Requirements

git 2.30 or newer (for worktree support)
tmux 3.2 or newer (for session persistence)
At least one supported agent CLI (claude, codex, or copilot)