Installation

Unfault is an open-source CLI. No account required. Download the binary and run it against your code.

Install the CLI

macOS (Apple Silicon)

mkdir -p ~/.local/bin
curl -L -o ~/.local/bin/unfault https://github.com/unfault/cli/releases/latest/download/unfault-aarch64-apple-darwin
chmod +x ~/.local/bin/unfault

macOS (Intel)

mkdir -p ~/.local/bin
curl -L -o ~/.local/bin/unfault https://github.com/unfault/cli/releases/latest/download/unfault-x86_64-apple-darwin
chmod +x ~/.local/bin/unfault

Linux (x86_64)

mkdir -p ~/.local/bin
curl -L -o ~/.local/bin/unfault https://github.com/unfault/cli/releases/latest/download/unfault-x86_64-unknown-linux-gnu
chmod +x ~/.local/bin/unfault

Linux (aarch64)

mkdir -p ~/.local/bin
curl -L -o ~/.local/bin/unfault https://github.com/unfault/cli/releases/latest/download/unfault-aarch64-unknown-linux-gnu
chmod +x ~/.local/bin/unfault

Windows (PowerShell)

$dest = "$env:USERPROFILE\bin\unfault.exe"
New-Item -ItemType Directory -Force (Split-Path $dest) | Out-Null
Invoke-WebRequest -Uri "https://github.com/unfault/cli/releases/latest/download/unfault-x86_64-pc-windows-msvc.exe" -OutFile $dest

Cargo (from source)

cargo install unfault

Downloads go to the latest release on GitHub. Put the binary somewhere on your PATH (e.g. ~/.local/bin on Linux/macOS).

Verify it works:

unfault --version

Optional: Configure an LLM

Some features (like AI-powered review summaries) require a configured LLM provider. This is optional. The core review and graph commands work without it.

Supported providers: OpenAI, Anthropic, Ollama, any OpenAI-compatible endpoint.

# OpenAI
unfault config llm openai --model gpt-4o

# Anthropic
unfault config llm anthropic --model claude-3-5-sonnet-latest

# Local Ollama
unfault config llm ollama --model llama3.2

See Configuration for the full reference.

Optional: Configure Observability Integrations

To enrich reviews with SLO data from your cloud platform, set the relevant credentials before running unfault review:

Provider	Required Variables
GCP Cloud Monitoring	Application Default Credentials (gcloud auth application-default login)
Datadog	DD_API_KEY, DD_APP_KEY
Dynatrace	DT_API_TOKEN, DT_ENVIRONMENT_URL

Run unfault config integrations show to check what’s detected, or unfault config integrations verify to test connectivity.

Next Steps

Quick Start

Run your first review and understand the output. Get started

How It Works

Understand what happens when you run a review. Learn more