Install

Zagens ships a Windows x64 desktop installer (this site’s download page), a cross-platform terminal TUI (zagens-tui), and a CLI (GitHub Releases / crates.io). All three use the Kernel V3 engine. These docs target product line v0.8.9 (desktop includes Browser, Diff Git, tool evidence composites, and more — see Getting started).

Step-by-step screenshots live on the public install guide page; this doc is a summary.

Desktop (Windows)

Installers are not yet code-signed; Windows may show SmartScreen warnings.

  1. Download the .exe or .zip from the download page.
  2. Recommended zip path: right-click → Properties → Unblock → extract → run the installer.
  3. If SmartScreen appears, choose More info → Run anyway (see FAQ).
  4. (Code mode) After first launch, complete the sidebar Sandbox wizard — see Windows sandbox.

CLI (no GUI)

The headless zagens CLI shares the desktop runtime — for scripts, CI, or servers without a GUI. Windows, macOS, and Linux.

crates.io (Rust required):

cargo install zagens-cli --bin zagens --locked
zagens --version

Prebuilt from GitHub Releases:

Download the binary for your OS from didclawapp-ai/zagens Releases (Windows: zagens-x86_64-pc-windows-msvc.exe) and add it to PATH.

Configure:

zagens doctor
# Edit ~/.zagens/config.toml (see product repo config.example.toml)

On Windows for Code workflows, run zagens sandbox setup afterward.

Full command reference: Headless CLI.

Terminal TUI (zagens-tui)

Full-screen three-column agent UI — same Kernel V3 engine and SQLite sessions as desktop. Best on macOS / Linux or when you prefer the terminal.

Prebuilt from GitHub Releases:

Download zagens-tui (same release page as the zagens CLI), add to PATH, then:

zagens-tui
zagens-tui --fresh

Full guide: Terminal TUI · Kernel V3

Verify the download (optional)

Copy the SHA-256 hash from the download page and compare:

Get-FileHash .\Zagens_*_x64-setup.exe -Algorithm SHA256

System requirements