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

bash
$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.

bash
$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

bash
$curl -fsSL https://gray.alignment.id/install-core.sh | sh
powershell
$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:

powershell
$irm https://gray.alignment.id/install.ps1 | iex

For the beta channel, pass arguments through a script block:

powershell
$& ([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.

FlagMeaning
-Channel stable|betarelease channel (default stable)
-InstallDir DIRinstall somewhere else (or set GRAY_INSTALL_DIR)
-NoPathleave the user PATH alone
-ArchivePath ZIP -Sha256 HEXoffline install from a downloaded zip
-Wslinstall the Linux build inside WSL instead

From source

bash
$cargo build --release -p gray

Join the Discord

Chat with the people building and running Gray. Show what you made with it.

Join Discord →

Need help?

Open an issue on GitHub, run /feedback from the REPL, or ask in Discord.

Open an issue →