HUD

A ZSH status bar written in Go, intended to be used as the precmd.

There is no configuration, everything is defined in the code. Run just build to recompile after updating the prompt.

Examples

Showing Git status:

─────╢ 18:32 ╟─────╢ 0 ╟─────────────────────────────────────╢ main* u+3 ╟─────

Showing Jujutsu status:

─────╢ 18:32 ╟─────╢ 0 ╟─────────────────╢ vkvz main ↥1 Update README.md ╟─────

Usage

hud --columns=$COLUMNS

ZSH Configuration

Run just build to compile the hud binary and add it to your $PATH.

PATH="$PATH:$HOME/path/to/hud/bin"

Configure the HUD to run as your precmd.

precmd () {
    # Important: capture exit code before running anything else
    exitcode="$?"
    if command -v hud &>/dev/null; then
        hud --columns="$COLUMNS" --exit-code="$exitcode"
    fi
}