Installation

Quick Install (macOS and Linux)

The fastest way to get gest is with the install script, which downloads a pre-built binary for your platform:

curl -fsSL https://gest.aaronmallen.dev/install | sh

This installs gest to ~/.local/bin. Make sure it is on your PATH:

export PATH="$HOME/.local/bin:$PATH"

To pin a specific version or change the install directory:

GEST_VERSION=x.y.z GEST_INSTALL_PATH=/usr/local/bin \
  curl -fsSL https://gest.aaronmallen.dev/install | sh

Install via Cargo

If you already have a Rust toolchain, install from crates.io:

cargo install gest

Or with cargo-binstall for a pre-built binary:

cargo binstall gest

Download from GitHub Releases

Pre-built binaries for macOS (Apple Silicon and Intel) and Linux (x86_64 and aarch64) are published with every release. Download the archive for your platform from the Releases page, extract it, and move the binary somewhere on your PATH:

# Example for macOS Apple Silicon
tar xzf gest-vX.Y.Z-aarch64-apple-darwin.tar.gz
mv gest ~/.local/bin/

Verify Installation

After installing, confirm gest is available:

gest version

You should see output showing the installed version, platform, and build revision.

The version command also checks for available updates. To update an existing install, run:

gest self-update