Installation

You can install hty in three ways: a one-line shell script that auto-detects your platform, a Homebrew tap, or building from source with Zig. All three produce the same single binary with no runtime dependencies.

Install script (macOS and Linux)

Run the install script with curl:


curl -fsSL https://raw.githubusercontent.com/LatentEvals/hty/main/scripts/install.sh | sh

The script auto-detects your OS and architecture, downloads the matching release binary from GitHub, verifies the checksum, and installs to ~/.local/bin.

To change the install directory, pass --install-dir or set the HTY_INSTALL_DIR environment variable:


curl -fsSL https://raw.githubusercontent.com/LatentEvals/hty/main/scripts/install.sh | sh -s -- --install-dir /usr/local/bin

All options:

Option	Description
`--version VERSION`	Release tag to install (default: latest)
`--install-dir DIR`	Install directory (default: `~/.local/bin` or `HTY_INSTALL_DIR`)
`--verify MODE`	`auto` \| `always` \| `never` — checksum verification (default: `auto`)
`--color MODE`	`auto` \| `always` \| `never` (default: `auto`)
`--force`	Overwrite existing binary without prompting
`--silent`	Suppress normal output
`--json`	Emit structured JSON lines instead of human output
`--dry-run`	Print what would happen without changing the system

If ~/.local/bin is not on your PATH, the script prints the exact line to add to your shell profile. You can also add it manually:


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

Homebrew (macOS)

Install hty from the official tap:


brew install LatentEvals/tap/hty

Homebrew handles PATH automatically. Run brew upgrade LatentEvals/tap/hty to upgrade to a newer release.

Prebuilt binaries

Download directly from the releases page :

OS	Architecture
macOS	aarch64 (Apple Silicon)
macOS	x86_64
Linux	x86_64
Linux	aarch64

From source

Building from source requires Zig 0.15 or later.


git clone https://github.com/LatentEvals/hty.git
cd hty
zig build -Doptimize=ReleaseFast
sudo cp zig-out/bin/hty /usr/local/bin/

Verify installation

After installing, confirm the binary is on your PATH and working:


hty --help

You should see the hty command list. If you get command not found, check that the install directory is on your PATH. Head to Quick Start to run your first session.