Skip to main content

​
Overview

The oobo update command checks for new versions of oobo and can automatically update to the latest release. It downloads binaries from the official GitHub releases.

​
Usage

oobo update [OPTIONS]

​
Options

​
--check
boolean
Only check for updates, don’t install
​
--agent
boolean
Output as JSON for machine parsing

​
Examples

​
Update to latest version

oobo update
Example output: 
Checking for updates...

Current version: 0.1.0
Latest version:  0.2.1

Downloading oobo v0.2.1 for linux-x86_64...
✓ Downloaded 4.2 MB

Installing...
✓ Installed to ~/.local/bin/oobo

Successfully updated to v0.2.1

Changelog: https://github.com/ooboai/oobo/releases/tag/v0.2.1

​
Check for updates without installing

oobo update --check
Example output: 
Current version: 0.1.0
Latest version:  0.2.1

A new version is available!

Run `oobo update` to upgrade.

​
JSON output for agents

oobo update --check --agent
Returns: 
{
  "status": "update_available",
  "current_version": "0.1.0",
  "latest_version": "0.2.1",
  "changelog_url": "https://github.com/ooboai/oobo/releases/tag/v0.2.1",
  "download_url": "https://github.com/ooboai/oobo/releases/download/v0.2.1/oobo-linux-x86_64.tar.gz"
}
If already up to date: 
{
  "status": "up_to_date",
  "current_version": "0.2.1",
  "latest_version": "0.2.1"
}

​
Update Process

1

Version check

Queries GitHub API for the latest release version
2

Platform detection

Determines your OS and architecture (macOS/Linux, x86_64/ARM64)
3

Download

Downloads the appropriate binary from GitHub releases
4

Verification

Verifies the download integrity (checksum if available)
5

Installation

Replaces the current binary at ~/.local/bin/oobo (or your install location)
6

Database migration

Runs any necessary database schema migrations for the new version

​
Supported Platforms

  • macOS: Apple Silicon (arm64), Intel (x86_64)
  • Linux: x86_64 (glibc), x86_64 (musl), ARM64 (aarch64)
The updater automatically detects your platform and downloads the correct binary.

​
Automatic Update Checks

Oobo checks for updates in the background and shows a notification if a new version is available (at most once per day). This can be disabled in config:
~/.oobo/config.toml
[update]
check_automatically = false

​
Troubleshooting

The install directory may not be writable. Try:
sudo oobo update
Or reinstall with the install script to fix permissions.
Check your internet connection and GitHub access. If behind a corporate firewall, you may need to download manually from GitHub releases.
Run oobo inspect --fix after updating. If the issue persists, back up ~/.oobo/ and reinstall.
Your PATH may be pointing to a different oobo binary. Check with:
which oobo
Ensure it points to ~/.local/bin/oobo (or your custom install location).

​
Manual Update

If automatic updates fail, you can manually download and install: 
# Download latest release
curl -fsSL https://oobo.ai/install.sh | bash

# Or download specific version
curl -fsSL https://oobo.ai/install.sh | OOBO_VERSION=0.2.1 bash

​
Version Command

To check your current version without updating: 
oobo version
This shows:
  • oobo version
  • Git version
  • Platform info
  • Install location
Oobo follows semantic versioning. Patch updates (0.1.0 → 0.1.1) are always safe. Minor updates (0.1.0 → 0.2.0) may add new features but maintain backward compatibility. Major updates (0.x → 1.x) may include breaking changes.

Version

Check current version

Inspect

Diagnose issues after updating

Installation

Installation guide

Build docs developers (and LLMs) love

Get started for freeTalk to us