zhist
Records zsh commands with directory, exit status, and duration for fzf search.
Tested on Linux
Use it
Linux x86_64
You need first
- System packages:
fzf
download linux_amd64 binary from GitHub releases and install to ~/.local/bin/zhist
curl -L -o /tmp/zhist.tar.gz https://github.com/overflowy/zhist/releases/download/v1.2.2/zhist_1.2.2_linux_amd64.tar.gz && mkdir -p ~/.local/bin && tar xzf /tmp/zhist.tar.gz -C /tmp && cp /tmp/zhist ~/.local/bin/zhist && chmod +x ~/.local/bin/zhist && zhist init > /tmp/zhist_init_out.txt
Where the README and reality differ
- README: CLI help via --help
What worked: zhist --help returns 'unknown command'; top-level usage is bare 'zhist' (exit 2) and per-subcommand 'zhist init --help'
Check that it works
zhist initThe output should contain “zmodload zsh/datetime”.
First thing to try
zhist initRun zhist init to set up zhist for your zsh shell.
What it does
These come from the README; pickfit didn’t check them one by one.
- Record commands with their directory and exit statusNot tested
- Browse your history in an fzf pickerNot tested
- Switch between global and current-directory historyNot tested
- Search stored commands by prefixNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- Main function works
- Works offline
Good for
- toggle between global and current-directory history
- delete selected history entry
- import existing zsh history file
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 31 Oct 2026
Differences the test machine hit
- README: go install github.com/overflowy/zhist@latest
In the test: box has no Go toolchain (go: command not found); installed prebuilt binary zhist_1.2.2_linux_amd64.tar.gz from GitHub releases to ~/.local/bin instead - README: Requires fzf 0.45 or newer for the picker
In the test: core CLI (init, add, list, search, get, import) works without fzf; picker not tested in headless box