Skip to content

Commit f1f2df3

Browse files
committed
docs: add comparison section to README
Compares gh-stack to similar tools: - Graphite: SaaS vs local-first - spr: one-commit-per-PR vs one-branch-per-PR - git-town: general workflow tool vs stacked-PR-focused - git-branchless: comprehensive Git suite vs narrow scope
1 parent fa28af4 commit f1f2df3

1 file changed

Lines changed: 24 additions & 0 deletions

File tree

README.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,30 @@ gh-stack stores metadata in your local `.git/config`:
135135

136136
No remote service required. Your stack relationships stay with your repository.
137137

138+
## Comparison
139+
140+
### vs. Graphite
141+
142+
[Graphite](https://graphite.dev/) is a SaaS product with a polished CLI and web dashboard. It requires an account and stores stack metadata on their servers. gh-stack stores everything locally in `.git/config`—no account, no remote dependency.
143+
144+
### vs. spr
145+
146+
[spr](https://github.com/ejoffe/spr) enforces a strict "one commit = one PR" model. You work on a single branch, and each commit automatically becomes a separate PR. You cannot merge PRs through GitHub's UI—you must use `spr merge`.
147+
148+
gh-stack uses a traditional "one branch = one PR" model. You control what goes into each PR, create PRs when you're ready, and merge through GitHub normally. More flexibility, less automation.
149+
150+
### vs. git-town
151+
152+
[git-town](https://github.com/git-town/git-town) is a general-purpose Git workflow tool that automates branch creation, synchronization, and cleanup across many workflows (Git Flow, GitHub Flow, trunk-based development). Stacked changes are one feature among many.
153+
154+
gh-stack focuses exclusively on stacked PRs. If you want a comprehensive Git workflow tool, use git-town. If you want a lightweight tool just for managing PR stacks on GitHub, use gh-stack.
155+
156+
### vs. git-branchless
157+
158+
[git-branchless](https://github.com/arxanas/git-branchless) is a powerful suite that enhances Git with undo functionality, interactive commit graph editing, and patch-stack workflows. It's designed for power users and optimized for massive repositories.
159+
160+
gh-stack is narrower in scope: it tracks parent-child relationships between branches and helps you manage the resulting PRs. It doesn't modify how Git works—it just adds stack awareness on top.
161+
138162
## Acknowledgements
139163

140164
Inspired by [Graphite](https://graphite.dev/).

0 commit comments

Comments
 (0)