docs · wh

Tiny git companion. Worktrees, minus the ceremony. History, diffs, and pull requests in plain english, in the terminal, or in the browser for any github repo. Local-first, telemetry-free, on your own key.

wh is a git companion with two surfaces. The cli manages worktrees so branch-switching never touches your working state, and explains diffs in plain english so review starts with understanding, not archaeology. The web app is a terminal for any repo you can see on github, cloned or not: what changed, the commit graph, pull requests, a file's history, why a line exists, and rebase or cherry-pick plans written out as commands to paste. Nothing is ever written to the repo or to github.

Local-first and telemetry-free. Explanations run on your own key (anthropic, openai, groq's free tier) or, in the cli, a local model via ollama, and an explanation sends the diff to that provider: see how the cli request travels and what leaves your browser. The cli needs nothing but git; the web needs a github sign-in and keys kept in your browser, never stored on the server.

Written in rust and typescript. The cli is one binary (0.6 MiB, budget 3.2 MiB), three small dependencies (clap, serde, serde_json), no runtime. The web app is a next.js app you run yourself. One explain spec (shared/prompts/) sits behind both, so an answer reads the same wherever you ask.

start here

install

cargo install from git, the shell wrapper, what the binary needs.

quick start

A worktree, a listing, a switch, a key, an explain, a prune.

web · run it

The browser terminal on your own machine or your own host.

terminal or web

Which surface answers which question.

status

Version 0.1.0, experimental. The first tagged release, with prebuilt binaries and a curl | bash installer, is still ahead; until then, install from git. The code is gpl-3.0.