Docs/Get started
Installation
Install the Gray AI agent harness with one curl command on macOS, Linux or WSL, one PowerShell line on Windows 11, or build it from source.
Source: dist/install.sh
Gray ships as a single statically linked binary: musl-static on Linux, Rust-static on macOS. The installer detects your platform, downloads the matching tarball from gray.alignment.id/dl, checks it against the release's published SHA256SUMS, and drops the binary on your PATH. There is no runtime to install and nothing to configure at install time.
macOS · Linux · WSL
$curl -fsSL https://gray.alignment.id/install.sh | sh
The beta channel rebuilds on every push to main. Use it if you want the newest fixes and can tolerate the occasional rough edge. See Updates & channels.
$curl -fsSL https://gray.alignment.id/install.sh | sh -s -- beta
The installer itself needs sh, curl or wget, tar, and sha256sum or shasum. Nothing else, and nothing afterwards.
Core install · no plugins
$curl -fsSL https://gray.alignment.id/install-core.sh | sh
$irm https://gray.alignment.id/install-core.ps1 | iex
The default install fetches account memory search gateway on macOS/Linux, plus fsearch on Linux; Windows fetches account memory search questions subagents mcp gateway — account carries login, whoami, logout and gray cloud. install-core skips them for a bare binary; GRAY_INSTALL_PLUGINS=0 does the same on the full script, and GRAY_PLUGINS="a b c" substitutes your own set. Other knobs: GRAY_INSTALL_DIR picks the destination, GRAY_CDN_URL mirrors the download host, GRAY_TELEMETRY=0 turns off the anonymous install ping.
Windows 11
Gray runs natively on Windows 11 x64: no WSL, no Linux distro, no elevation. In PowerShell 5.1 or 7:
$irm https://gray.alignment.id/install.ps1 | iex
For the beta channel, pass arguments through a script block:
$& ([scriptblock]::Create((irm https://gray.alignment.id/install.ps1))) -Channel beta
The installer downloads gray-<channel>-x86_64-windows.zip, verifies it against the release's SHA256SUMS, checks the archive holds only gray.exe and its license files, test-runs gray.exe --version, and only then replaces any existing binary. It installs to %LOCALAPPDATA%\Programs\gray\bin and adds that to your user PATH — open a new terminal afterwards. Read install.ps1 and install-native.ps1 first if you like.
| Flag | Meaning |
|---|---|
| -Channel stable|beta | release channel (default stable) |
| -InstallDir DIR | install somewhere else (or set GRAY_INSTALL_DIR) |
| -NoPath | leave the user PATH alone |
| -ArchivePath ZIP -Sha256 HEX | offline install from a downloaded zip |
| -Wsl | install the Linux build inside WSL instead |
From source
$cargo build --release -p gray
Join the Discord
Chat with the people building and running Gray. Show what you made with it.
Join Discord →