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.

Options

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

# Install a specific version
VERSION=0.15.5 curl -fsSL https://omegon.styrene.dev/install.sh | sh

# 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 release from GitHub, 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:

Verify a Download

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

Provider Setup

After installing, you need at least one inference provider configured. The fastest path:

Option A: Claude Pro/Max Subscription (Free)

omegon login

Opens a browser for OAuth authentication. No API key needed.

Option B: API Key

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

Option C: Local Inference (Ollama)

# Install Ollama (https://ollama.ai)
ollama pull qwen3:32b
omegon

Omegon auto-detects Ollama and routes local-tier requests to it.

See Providers for all 10 supported inference providers.

Updates

Omegon checks for updates automatically at startup (5-second delay, non-blocking). When a newer version is available, you'll see a toast notification and can run /update to view release notes.

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

Supported Platforms

PlatformArchitectureStatus
macOSaarch64 (Apple Silicon)✓ Primary
macOSx86_64 (Intel)✓ Supported
Linuxx86_64✓ Supported
Linuxaarch64✓ Supported (cross-compiled)
WindowsUse WSL2