Skip to content

git-town/git-town

Repository files navigation

Git Town logo
end-to-end test status unit test status linters and documentation test status windows tests Go report card status Netlify deploy status

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

Configuration

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.

Stargazers over time