Installation

grüt can be installed with a single command on Linux, macOS, and Windows — or built from source with Go.

irm https://raw.githubusercontent.com/jongio/grut/main/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/jongio/grut/main/install.sh | bash
go install github.com/jongio/grut@latest

Pin a Specific Version

Set the VERSION environment variable to install a specific release:

VERSION=v0.1.0 curl -fsSL https://raw.githubusercontent.com/jongio/grut/main/install.sh | bash
$env:VERSION = "v0.1.0"; irm https://raw.githubusercontent.com/jongio/grut/main/install.ps1 | iex

Binary Download

Prebuilt binaries for Linux, macOS, and Windows are available on theGitHub Releases page. Download the archive for your OS and architecture, extract it, and move the binary to a directory on your PATH.

  1. Go to github.com/jongio/grut/releases
  2. Download the archive for your platform (e.g. grut_linux_amd64.tar.gz)
  3. Extract: 
    tar xzf grut_linux_amd64.tar.gz
  4. Move the binary: 
    sudo mv grut /usr/local/bin/

System Requirements

  • Go 1.26+ — required only if building from source
  • Terminal — any modern terminal with 256-color support (iTerm2, Windows Terminal, Alacritty, Ghostty, Kitty, etc.)
  • Nerd Font — recommended for file icons. Without one, grüt falls back to ASCII icons. Popular choices: JetBrainsMono Nerd Font, 0xProto Nerd Font, FiraCode Nerd Font.
  • Git — grüt shells out to git for all operations, so a working git on your PATH is required.

Verify Installation

After installing, verify grüt is available:

grut --version

You should see the installed version printed to the terminal.

Updating

grüt includes a built-in self-update command that downloads the latest release from GitHub, verifies the SHA-256 checksum, and replaces the running binary:

grut update

A background update check also runs automatically on every launch. If a newer version is available, grüt will notify you when the TUI exits.