Installation

Installation

Linux / macOS — one-liner (recommended)

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/GokhanTurk/gukab/releases/latest/download/gukab-installer.sh | sh

Downloads the right prebuilt binary for your platform (x86_64 Linux, or Apple Silicon / Intel Mac) and installs it to ~/.local/bin. No Rust toolchain required. Make sure ~/.local/bin is on your PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Manual download

Grab the archive for your platform from the latest release, extract, and move the gukab binary onto your PATH:

Platform	Archive
Linux x86_64 (Arch)	gukab-x86_64-unknown-linux-gnu.tar.xz
Apple Silicon Mac	gukab-aarch64-apple-darwin.tar.xz
Intel Mac	gukab-x86_64-apple-darwin.tar.xz

tar xf gukab-*.tar.xz
sudo mv */gukab /usr/local/bin/   # or ~/.local/bin

macOS: if you see "developer cannot be verified", clear the quarantine flag: xattr -d com.apple.quarantine <path-to-gukab>.

From source

Requires a Rust toolchain:

git clone https://github.com/GokhanTurk/gukab
cd gukab && cargo install --path .

Updating

If you used the one-liner, a self-updater is installed alongside:

gukab-update

Or re-run the install one-liner (always fetches the latest). From-source installs update with git pull && cargo install --path ..

macOS: after each update, run gukab --trust-keychain once to stop the keychain re-prompting for every host — see Security.

Version / help

gukab --version    # or -V
gukab --help       # or -h