hhHalfhand

Shell completions

hh can print a completion script for your shell on stdout:

hh completions bash
hh completions zsh
hh completions fish
hh completions powershell

hh --help lists completions with a usage example. The script is plain text and pipe-safe — redirect it wherever your shell expects.

Install per shell

bash

hh completions bash | sudo tee /etc/bash_completion.d/hh >/dev/null
# or, per-user:
hh completions bash > ~/.local/share/bash-completion/completions/hh

Then start a new shell (or source the file).

zsh

zsh looks in any directory on $fpath for files named _hh:

hh completions zsh > ~/.zsh/completions/_hh
# ensure the dir is on fpath (in ~/.zshrc):
#   fpath=(~/.zsh/completions $fpath)
#   autoload -Uz compinit && compinit

fish

hh completions fish > ~/.config/fish/completions/hh.fish

fish picks it up immediately.

PowerShell

hh completions powershell | Out-String | Invoke-Expression

or save it to your $PROFILE:

hh completions powershell > $PROFILE\..\hh-completions.ps1
# then dot-source it from $PROFILE

In release artifacts

Pre-generated completion scripts and the hh.1 man page are bundled in every Halfhand release archive under completions/ and man/. If you installed via the shell installer or Homebrew, see the tap caveats; otherwise copy the files from the archive into the locations above.

Man page

The hh.1 man page is generated alongside completions and shipped in release archives. Install it manually if you built from source:

# from a release archive, or generated locally with `just dist-assets`:
cp man/hh.1 ~/.local/share/man/man1/
mandb
man hh