Installation

Homebrew (macOS & Linux)

brew tap ooboai/tap
brew install oobo

Upgrade later with brew upgrade oobo.

Install script - macOS & Linux (humans)

curl -fsSL https://oobo.ai/install.sh | bash

The script detects your OS and architecture, downloads the correct binary from GitHub Releases, and places it in ~/.oobo/bin/. It also adds that directory to your PATH by appending to your shell RC file (.zshrc, .bashrc, or config.fish).

Install script - macOS & Linux (agents)

For AI agents and CI environments, pass --agent for silent install with JSON output:

curl -fsSL https://oobo.ai/install.sh | bash -s -- --agent

On success, this prints a single JSON line:

{"status":"ok","version":"v2.0.0","binary":"/home/user/.oobo/bin/oobo","platform":"x86_64-unknown-linux-gnu"}

On failure:

{"error":"unsupported platform: ..."}

No colors, no progress bars, no interactive prompts. The --agent flag exists so that AI coding agents (Cursor, Claude Code, Codex, etc.) can install oobo programmatically without parsing human-readable output.

How agents find the install command

Oobo ships with a skill file at ~/.agents/skills/oobo/SKILL.md. The YAML frontmatter includes:

install:
  check: command -v oobo
  run: curl -fsSL https://oobo.ai/install.sh | bash -s -- --agent

Most AI coding tools scan ~/.agents/skills/ for skill files automatically. When an agent reads oobo’s skill, it knows how to check if oobo is installed and how to install it if not. The skill file is installed during oobo setup. The canonical file lives at ~/.oobo/skills/oobo/SKILL.md and is symlinked into supported agent skill directories.

oobo setup --non-interactive

Install script - Windows

irm https://oobo.ai/install.ps1 | iex

The PowerShell script downloads the Windows binary from GitHub Releases and places it in ~/.oobo/bin/. It adds that directory to your user PATH automatically.

Environment variables

The install scripts respect these environment variables:

Variable	Default	Description
`OOBO_INSTALL_DIR`	`~/.oobo/bin`	Override the install directory
`OOBO_VERSION`	latest	Install a specific version tag
`OOBO_NO_MODIFY_PATH`	unset	Set to `1` to skip PATH modification

Download binary

Grab a pre-built binary from GitHub Releases. Supported platforms:

OS	Architecture	Binary
macOS	Apple Silicon (aarch64)	`oobo-<version>-aarch64-apple-darwin.tar.gz`
macOS	Intel (x86_64)	`oobo-<version>-x86_64-apple-darwin.tar.gz`
Linux	x86_64 (glibc)	`oobo-<version>-x86_64-unknown-linux-gnu.tar.gz`
Linux	x86_64 (musl/static)	`oobo-<version>-x86_64-unknown-linux-musl.tar.gz`
Linux	ARM64 (glibc)	`oobo-<version>-aarch64-unknown-linux-gnu.tar.gz`
Linux	ARM64 (musl/static)	`oobo-<version>-aarch64-unknown-linux-musl.tar.gz`
Windows	x86_64	`oobo-<version>-x86_64-pc-windows-msvc.zip`

Build from source

Requires Rust (tested with 1.94+).

git clone https://github.com/ooboai/oobo.git && cd oobo
cargo build --release
# binary at target/release/oobo

Or install directly:

cargo install --git https://github.com/ooboai/oobo --locked

Docker

FROM rust:1-slim AS builder
WORKDIR /build
COPY Cargo.toml Cargo.lock ./
COPY src/ src/
RUN cargo build --release

FROM debian:bookworm-slim
COPY --from=builder /build/target/release/oobo /usr/local/bin/
ENTRYPOINT ["oobo"]

Self-update

Once installed, oobo can update itself:

oobo update           # download and install latest
oobo update --check   # just check, don't install

Verify installation

oobo --version

Prints the installed oobo version.

Get Started

Usage

Deep Dives

Installation

Homebrew (macOS & Linux)

Install script - macOS & Linux (humans)

Install script - macOS & Linux (agents)

How agents find the install command

Install script - Windows

Environment variables

Download binary

Build from source

Docker

Self-update

Verify installation

​Homebrew (macOS & Linux)

​Install script - macOS & Linux (humans)

​Install script - macOS & Linux (agents)

​How agents find the install command

​Install script - Windows

​Environment variables

​Download binary

​Build from source

​Docker

​Self-update

​Verify installation

Homebrew (macOS & Linux)

Install script - macOS & Linux (humans)

Install script - macOS & Linux (agents)

How agents find the install command

Install script - Windows

Environment variables

Download binary

Build from source

Docker

Self-update

Verify installation