Install

Linux

The install script detects your architecture, downloads the matching release, verifies its SHA-256, and installs octo to your PATH:

curl -fsSL https://octo-agent.dev/install.sh | sh

Then start the local server and onboard in your browser:

octo serve -d                  # run the local server in the background
xdg-open http://127.0.0.1:8088 # opens the dashboard

127.0.0.1 is loopback, so no access key is needed — the page goes straight into first-run onboarding (pick a provider, paste a key). Stop the server later with octo serve --stop. Prefer the terminal? Just run octo.

Prefer a GUI? Grab the desktop app — Octo-x86_64.AppImage from the latest release; chmod +x and run it. It needs GTK4 + WebKitGTK 6.0 on the host (most current desktops have them; the app tells you what to install if not).

Prebuilt archives (linux / darwin / windows × amd64 + arm64) and checksums.txt are on the latest release if you’d rather grab one by hand.

macOS

Install script (command line) — same one-liner as Linux:

curl -fsSL https://octo-agent.dev/install.sh | sh
octo serve -d                  # run the local server in the background
open http://127.0.0.1:8088     # opens the dashboard

Double-click installer — download octo-setup.pkg from the latest release (one universal package covers both Apple Silicon and Intel) and double-click it.

1. Installer.app offers only “Install for me only” — no administrator password.
2. It installs the Octo desktop app to ~/Applications/Octo.app and puts the bundled octo CLI on your PATH (appends to ~/.zprofile / ~/.bash_profile / ~/.profile).
3. When it finishes it opens the app — a native window, so there’s no browser or background server to manage.
4. For a terminal session, open a new terminal and run octo.

Gatekeeper warning expected

The app isn’t notarized, so Gatekeeper will warn it’s from an unidentified developer — right-click (Control-click) Octo.app → Open, or allow it via System Settings → Privacy & Security → Open Anyway. There’s no App Store-style uninstaller for .pkg; run ~/.octo/uninstall.sh to remove it (your ~/.octo data is left intact).

Windows

Install script (PowerShell) — the 3-platform counterpart to the curl … | sh one-liner. It detects your arch, verifies the SHA-256, installs octo.exe per-user, and puts it on your PATH:

irm https://octo-agent.dev/install.ps1 | iex

Double-click installer — download octo-setup.exe from the latest release and double-click it.

1. It installs per-user (no administrator prompt) the Octo desktop app plus the octo CLI, puts the CLI on your PATH, and adds a Start-menu entry that launches the app.
2. When it finishes it opens the app — a native window, nothing to manage in the background.
3. For a terminal session, open a new terminal and run octo.

The installer isn’t code-signed yet, so Windows SmartScreen may show “Windows protected your PC” — click More info → Run anyway. Uninstall from “Add or remove programs” like any other app.

Upgrading

octo upgrade         # installs the latest release in place, SHA-256 verified
octo upgrade --check # only compares versions

The web UI’s version badge offers the same flow.

From Go or from source

go install github.com/open-octo/octo-agent/cmd/octo@latest

git clone https://github.com/open-octo/octo-agent.git
cd octo-agent
make build       # produces ./octo

Next: Quickstart.