Install

On macOS and Windows the recommended path is a package manager. They track the latest stable tag and get you past the first-launch Gatekeeper / SmartScreen warnings. System requirements (OS floors, runtime dependencies) and building from source live in Requirements.

macOS (Homebrew)

The tap packetThrower/tap ships a zorite cask (stable) and a zorite@alpha cask (pre-release). As of Homebrew 6.0.0 (June 2026), third-party taps must be trusted before Homebrew runs their code, so tap and trust it first:

brew tap packetThrower/tap
brew trust packetThrower/tap         # trust the tap (Homebrew 6.0.0+)
brew install --cask zorite           # stable
brew install --cask zorite@alpha     # pre-release

To trust only the cask you’re installing rather than the whole tap, use brew trust --cask packetThrower/tap/zorite in place of brew trust packetThrower/tap. See Homebrew’s Tap Trust docs for the details.

The cask handles the macOS quarantine attribute for you, so the app launches without the right-click → Open prompt that a direct download needs. Zorite’s macOS builds are ad-hoc signed but not notarized; the cask is the path that sidesteps Gatekeeper. Update with brew upgrade --cask zorite.

Windows (winget)

winget is Microsoft’s own package manager, preinstalled on Windows 10 1809+ and Windows 11. It resolves either by the full identifier or the short moniker:

winget install packetThrower.Zorite    # full identifier
winget install zorite                   # short moniker (same result)

winget picks the right architecture automatically (x64 or arm64) based on the host. It carries stable only — for pre-release builds on Windows use Scoop below or grab the artifact directly from the Releases page. Update with winget upgrade packetThrower.Zorite.

Windows (Scoop)

The bucket packetThrower/scoop-bucket ships two manifests: zorite (stable) and zorite-prerelease.

# Scoop needs git to fetch + update buckets. If `git --version`
# already prints something, skip this line.
scoop install git

scoop bucket add packetThrower https://github.com/packetThrower/scoop-bucket
scoop install zorite                # stable
scoop install zorite-prerelease     # pre-release

Update with scoop update zorite (or zorite-prerelease).

Linux

There’s no package-manager bucket for Linux — grab the matching artifact for your distro from the Releases page:

Distro	Artifact	Install
Debian / Ubuntu	`.deb`	`sudo apt install ./zorite_<version>_amd64.deb`
Fedora / RHEL	`.rpm`	`sudo dnf install ./zorite-<version>.x86_64.rpm`
Arch	`.pkg.tar.zst`	`sudo pacman -U zorite-<version>-x86_64.pkg.tar.zst`
Any glibc distro	`.AppImage`	`chmod +x` then run it

For ARM64 hosts use the matching arm64 / aarch64 artifact. Linux also needs a Vulkan-capable GPU with current Mesa drivers — see Requirements.

Direct download (any OS)

If you’d rather not go through a package manager, every release on GitHub Releases ships the same artifacts the package managers consume: .dmg and .pkg (macOS), .exe / .msi (Windows), and .deb / .rpm / .AppImage / .pkg.tar.zst (Linux), each per architecture, plus SHA256SUMS.

To install by hand, download from Releases and drag Zorite.app to /Applications on macOS, or run the installer on Windows. Two bits of first-launch friction live on this path; the brew / winget / scoop installs sidestep both:

macOS Gatekeeper. Direct builds are ad-hoc signed but not notarized. Right-click → Open on first launch, or run xattr -cr Zorite.app to strip the quarantine attribute.
Windows SmartScreen. The installer is unsigned. Click More info → Run anyway.

Notarized macOS and signed Windows builds are planned — see TODO.md.

Pre-release channel

Pre-release tags (vX.Y.Z-alpha.N, -beta.N, -rc.N) publish under GitHub’s “Pre-release” badge and don’t displace the “Latest release” pointer. Homebrew (zorite@alpha) and Scoop (zorite-prerelease) each expose a separate manifest for that channel; winget is stable-only. Linux users grab a pre-release tag’s artifact directly from the Releases page.

Building from source

A small Rust workspace — the app plus three reusable crates. See Requirements for the per-OS system libraries.

git clone git@github.com:packetThrower/zorite.git
cd zorite
cargo run                       # debug build + launch
cargo build --release           # optimized binary at target/release/zorite
cargo test --workspace          # run the tests

The first cargo build compiles gpui’s full dependency graph and takes a few minutes; incremental builds are fast.