Branch workflow automation with git-town. Use when creating feature branches, syncing with upstream, proposing PRs, or managing stacked branch workflows.
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.
main)Initialize git-town in a repository:
git town init
This walks through configuration: main branch, perennial branches, hosting platform, and sync strategy.
git town hack feature-name # Create feature branch from main
git town sync # Rebase onto parent, push
git town propose # Open PR targeting parent branch
git town switch # Interactive branch switcher
git town append child-name # Create child of current branch
git town up # Move to child branch
git town down # Move to parent branch
git town sync --stack # Sync current branch and descendants
git town propose --stack # Propose PRs for entire stack
See stacking.md for complete stacked workflow documentation.
git town undo # Reverse last git-town command
git town continue # Resume after resolving conflicts (git add first)
git town skip # Skip problematic commit during rebase
git town abort # Cancel operation and restore previous state
git-town works with git worktrees. Branch metadata is stored in git config, shared across all worktrees.
Limitation: git town hack --beam may not prompt for commits when using worktrees (#5690). Use git town hack without --beam, then cherry-pick manually.
