Quickstart
Install
Pick one. All three install the hh binary.
cargo (any OS with a Rust toolchain):
cargo install halfhand
Homebrew (macOS/Linux):
brew tap halfhand-org/tap
brew install hh
Shell installer (downloads a prebuilt binary + checksum from the latest GitHub release):
curl --proto '=https' --tlsv1.2 -LsSf https://halfhand.org/install.sh | sh
The installer places
hhin~/.halfhand/binby default; add it to yourPATHif it isn't already.
Verify:
hh --version
30-second demo
hh run -- claude # record a Claude Code session (or any command)
hh replay last # faithfully play it back in an interactive TUI
hh inspect last # non-interactive summary + step table
hh list # every recording, newest first
That's the whole loop. hh delete last --yes removes a recording.
Where your data lives
Recordings go in your Halfhand data dir (~/.local/share/halfhand/ on Linux,
~/Library/Application Support/halfhand/ on macOS, %APPDATA%\halfhand\data\
on Windows, by default). Run hh init to create it along with a commented
starter config and print every path. It's optional, since hh creates what
it needs on first use. See Setup. Point it elsewhere with
HH_DATA_DIR:
HH_DATA_DIR=./hh-data hh run -- echo hello
HH_DATA_DIR=./hh-data hh list
Next
- Recording —
hh runflags and what gets captured. - Replay & Inspect — the TUI and the JSON view.
- Redaction — scan and remove secrets before sharing.
- Export & import — portable
.hhbundles and HTML.