worktrunk
Worktrunk
Overview
A git worktree is a second checkout of one repository in another directory, on another branch.
That is the cheapest isolation available for parallel work: two agents editing two worktrees
cannot overwrite each other's files, yet they share history and can merge locally. Worktrunk's
wt binary wraps the bookkeeping. You name a branch and it derives the directory, runs the
project's setup hooks, optionally starts a program there, reports the state of every checkout in
one table, and lands a finished branch with tests run first and the leftovers removed.
Everything below was run against version 0.80.0 in a throwaway repository. Note that
.worktrunk.toml and keys such as on_create or [create] copy do not exist; the real files
and keys are in step 3 and step 4.