From: Ethan Smith Date: Sun, 10 May 2026 18:33:21 +0000 (-0400) Subject: docs: add motivation section explaining the problem gw solves X-Git-Url: https://git.project802.io/?a=commitdiff_plain;h=HEAD;p=gw.git docs: add motivation section explaining the problem gw solves Co-Authored-By: Claude Opus 4.5 --- diff --git a/README.md b/README.md index a26adc0..c5e9b3e 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,14 @@ Git worktree manager that mirrors branch names to directory paths. +## Why + +When switching between branches and features, getting pulled in different directions throughout the day, the constant `git stash`, `git checkout`, `git stash pop` cycle becomes tedious and error-prone. I needed a cleaner way to keep different workpaths separated so I could jump between tasks instantly. + +Git worktrees solve this perfectly: each branch lives in its own directory with its own working state. But setting them up cleanly is clunky - you end up with scattered directories and manual bookkeeping. + +`gw` aims to be that clean setup. It organizes worktrees into a predictable structure where branch names map directly to directory paths (`feature/auth` → `feature/auth/`), and switching is instant. + ## Install ```bash