git-town

git-town automates common git workflows: creating branches, syncing with upstream, and managing stacked PRs. It tracks branch relationships in git config and works with GitHub, GitLab, Bitbucket, Gitea, and Forgejo.

Mental Model

• Branches have parents: Every feature branch tracks its parent (usually main)
• Sync keeps you current: Pull upstream changes, rebase your work, push results
• Propose creates PRs: Opens PRs targeting the correct parent branch
• Undo is always available: Any git-town command can be reversed

Getting Started

Initialize git-town in a repository:

git town init