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.

Options

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

# Install a specific stable or RC 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)

brew tap styrene-lab/tap
brew install omegon

The Homebrew formula downloads the latest GitHub release, verifies the checksum, and installs to your Homebrew prefix. Updates via brew upgrade 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
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
omegon

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-..."
omegon

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

Option C: OpenAI/Codex OAuth or local Ollama

# OpenAI/Codex OAuth
omegon login openai-codex
omegon

# Or local inference
ollama pull qwen3:32b
omegon

Omegon auto-detects Ollama for local-tier work. OpenAI/Codex gives you the ChatGPT/Codex-backed route without requiring an OpenAI API key.

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, you can run /update to inspect and install it.

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

Supported Platforms