]> git.project802.io - gw.git/commitdiff
docs: add motivation section explaining the problem gw solves main
authorEthan Smith <esmith@project802.io>
Sun, 10 May 2026 18:33:21 +0000 (14:33 -0400)
committerEthan Smith <esmith@project802.io>
Sun, 10 May 2026 18:34:42 +0000 (14:34 -0400)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
README.md

index a26adc0eda3638f7344ae14d48041af404f61b28..c5e9b3ed32e4715a1f917e67fbf1070d073ed5ac 100644 (file)
--- 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