Installation

Quick Install (Recommended)

curl -fsSL https://omegon.styrene.dev/install.sh | sh

Downloads the latest signed binary for your platform (macOS arm64/x86_64, Linux x86_64/aarch64), verifies the SHA-256 checksum, and installs to /usr/local/bin by default.

This preview site tracks staging guidance. RC and nightly instructions stay here; public stable installs remain on https://omegon.styrene.io.

Options

# Install to a custom directory
INSTALL_DIR=~/.local/bin curl -fsSL https://omegon.styrene.dev/install.sh | sh

# Install latest RC
CHANNEL=rc curl -fsSL https://omegon.styrene.dev/install.sh | sh

# Install latest nightly
CHANNEL=nightly curl -fsSL https://omegon.styrene.dev/install.sh | sh

# Install a specific stable, RC, or nightly-pinned version
VERSION=0.15.10 curl -fsSL https://omegon.styrene.dev/install.sh | sh
# Replace 0.15.10 with the release you actually want

# Non-interactive (CI)
curl -fsSL https://omegon.styrene.dev/install.sh | sh -s -- --no-confirm

Homebrew (macOS / Linux)

Stable

brew tap styrene-lab/tap
brew install omegon

Tracks the latest stable release. Updates via brew upgrade omegon.

RC channel

brew tap styrene-lab/tap
brew install styrene-lab/tap/omegon-rc

Tracks the latest release candidate. Updated automatically by CI on every RC cut. Updates via brew upgrade styrene-lab/tap/omegon-rc.

omegon-rc conflicts with omegon — both install the same binary name. Switch back to stable with:

brew unlink omegon-rc
brew install omegon

GitHub Releases

Download release artifacts directly from GitHub Releases. Each release includes:

• Pre-built binaries for macOS (arm64, x86_64) and Linux (x86_64, aarch64)
• SHA-256 checksums
• Sigstore cosign signatures (keyless)
• CycloneDX SBOM
• GitHub Attestations (build provenance)
• Installer/update metadata used by /update for verification before install

Verify a Download

# Verify cosign signature (keyless)
# Replace 0.15.10 with the release you downloaded
# Replace 0.15.10 with the release you downloaded
cosign verify-blob omegon-0.15.10-aarch64-apple-darwin.tar.gz \
  --signature omegon-0.15.10-aarch64-apple-darwin.tar.gz.sig \
  --certificate omegon-0.15.10-aarch64-apple-darwin.tar.gz.pem \
  --certificate-identity-regexp '.*' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

The versioned filenames above are examples. Replace them with the exact artifact you downloaded.

Provider Setup

After installing, you need at least one inference provider configured. Three fast paths:

Option A: Anthropic/Claude interactive subscription path

omegon login anthropic
om

Opens a browser for OAuth authentication. This path is for interactive TUI use. Omegon will block headless and automated entry points when this is your only Anthropic credential.

Option B: API key path

export ANTHROPIC_API_KEY="sk-ant-..."
om

Use this when you want clean automation semantics for prompts, smoke runs, or cleave workers.

Option C: OpenAI/Codex OAuth, Ollama Cloud, or local Ollama

# OpenAI/Codex OAuth
omegon login openai-codex
om

# Hosted Ollama
omegon login ollama-cloud
om

# Or local inference
ollama pull qwen3:32b
om

Omegon auto-detects Ollama for local-tier work. OpenAI/Codex gives you the ChatGPT/Codex-backed route without requiring an OpenAI API key. Ollama Cloud is a separate hosted provider from local Ollama, authenticated via OLLAMA_API_KEY and configurable through /login or /secrets.

Omegon installs two entrypoints from the same binary: om (slim, copy-friendly, familiar terminal mode) and omegon (full harness). You can always override the startup posture with om --full or omegon --slim.

See Providers for all supported auth modes and boundaries.

Updates

Omegon checks for updates automatically at startup (non-blocking). When a newer version is available, the TUI shows a notification.

Homebrew installs

# Stable
brew upgrade omegon

# RC channel
brew upgrade styrene-lab/tap/omegon-rc

The in-app /update command detects Homebrew-managed installs and redirects to the appropriate brew upgrade command automatically. Do not use the install script to update a Homebrew-managed binary — it will conflict with brew's version tracking.

Script installs

# Re-run the install script to update
curl -fsSL https://omegon.styrene.dev/install.sh | sh

Supported Platforms