Installation

Quick Install (Recommended)

curl -fsSL https://omegon.styrene.io/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.

Options

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

# Install latest nightly (bleeding-edge from main)
curl -fsSL https://omegon.styrene.io/install.sh | sh -s -- --channel=nightly

# Install the 0.28.0 stable release
# Replace 0.28.0 with the release you actually want
curl -fsSL https://omegon.styrene.io/install.sh | sh -s -- --version=v0.28.0

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

Homebrew (macOS / Linux)

brew tap styrene-lab/tap
brew install omegon

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

On Linux, Homebrew does not provide a newer host glibc for Omegon. If the downloaded binary requires a newer glibc than your distribution has, install can succeed but runtime startup will fail. Check with ldd --version before relying on Linux Homebrew in older distributions.

GitHub Releases

Download release artifacts directly fromGitHub 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

cosign verify-blob omegon-0.28.0-aarch64-apple-darwin.tar.gz \
  --signature omegon-0.28.0-aarch64-apple-darwin.tar.gz.sig \
  --certificate omegon-0.28.0-aarch64-apple-darwin.tar.gz.pem \
  --certificate-identity-regexp '.*' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

The filenames above target the 0.28.0 release. Replace 0.28.0 with the release 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 auth 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

omegon secret set ANTHROPIC_API_KEY --stdin
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 auth login openai-codex
om

# Hosted Ollama
omegon auth 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 /auth login or /secrets.

Omegon installs two entrypoints from the same binary:om (slim, copy-friendly, familiar terminal mode) andomegon (full harness). You can always override the startup posture withom --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

brew upgrade omegon

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.io/install.sh | sh

Supported Platforms