HUD

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

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

For performance, the version control section is opt-in. Pass the --vcs flag to enable.

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
}