Git Town makes software development teams who use Git even more productive and happy. It adds Git commands that support GitHub Flow, Git Flow, the Nvie model, GitLab Flow, and other workflows more directly, and it allows you to perform many common Git operations faster and easier.

See git-town.com for documentation.

Git Town provides these additional Git commands:

Development Workflow

• git hack - cuts a new up-to-date feature branch off the main branch
• git sync - updates the current branch with all ongoing changes
• git new-pull-request - create a new pull request
• git ship - delivers a completed feature branch and removes it

Repository Maintenance

• git kill - removes a feature branch
• git prune-branches - delete all merged branches
• git rename-branch - rename a branch
• git repo - view the repository homepage

Configuration and Help

• git town - general Git Town help, view and change Git Town configuration

Git Town runs anywhere Git and Bash run. Check out our installation instructions for more details.

Git Town is configured on a per-repository basis. Upon first use in a repository, you will be prompted for the required configuration. Use the git town command to view or update your configuration at any time.

• the main development branch
• the perennial branches

The following configuration options have defaults, so the configuration wizard does not ask about them.

• the pull branch strategy
  • how to sync the main branch / perennial branches with their upstream
  • default: rebase
  • possible values: merge, rebase

In addition to the online documentation here, you can run git town on the command line for an overview of the Git Town commands, or git help <command> (e.g. git help sync) for help with an individual command.

Found a bug or have an idea for a new feature? Open an issue or - even better - get down, go to town, and fire a feature-tested pull request our way! Check out our contributing guide to start coding.