Git Town makes it easy to create and synchronize Git branches. Compatible with all major Git workflows including Git Flow, GitHub Flow, GitLab Flow, and trunk-based development. Supports mono-repos and stacked changes. Check out this screencast for an introduction.

Typical development commands

• git hack - create a new up-to-date feature branch off the main branch
• git sync - update existing branches, remove shipped branches
• git propose - create a pull or merge request for a feature branch

Stacked changes

• git append - insert a new branch as a child of the current branch
• git prepend - insert a new branch between the current branch and its parent
• git set-parent - update the parent of a branch

Branch Types

• git observe - track somebody else's feature branch without contributing to it
• git contribute - add commits to somebody else's feature branch
• git park - stop syncing one of your feature branches

Advanced development commands

• git kill - remove a feature branch
• git rename-branch - rename a branch
• git repo - view the repository homepage
• git ship - merge a completed feature branch and remove it

Configuration

• git town config - display or update your Git Town configuration
• git town version - display the installed version of Git Town

Installation

See the installation and configuration instructions.

Documentation

The Git Town website provides documentation for Git Town users. git town help [command] shows help on the CLI.

Contributing

Found a bug or have an idea for a new feature? Open an issue or send a pull request! Our developer documentation helps you get started.