Skip to main content

​
Install script (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 (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":"v0.1.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. If you want to install it manually: 
oobo agent     # prints the skill file to stdout

​
Environment variables

The install script respects these environment variables:
VariableDefaultDescription
OOBO_INSTALL_DIR~/.oobo/binOverride the install directory
OOBO_VERSIONlatestInstall a specific version tag
OOBO_NO_MODIFY_PATHunsetSet to 1 to skip PATH modification

​
Download binary

Grab a pre-built binary from GitHub Releases. Supported platforms:
OSArchitectureBinary
macOSApple Silicon (aarch64)oobo-<version>-aarch64-apple-darwin.tar.gz
macOSIntel (x86_64)oobo-<version>-x86_64-apple-darwin.tar.gz
Linuxx86_64 (glibc)oobo-<version>-x86_64-unknown-linux-gnu.tar.gz
Linuxx86_64 (musl/static)oobo-<version>-x86_64-unknown-linux-musl.tar.gz
LinuxARM64 (glibc)oobo-<version>-aarch64-unknown-linux-gnu.tar.gz
LinuxARM64 (musl/static)oobo-<version>-aarch64-unknown-linux-musl.tar.gz

​
Build from source

Requires Rust 1.75+. 
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
Shows oobo version, git version, database location, and detected AI tools.