marcelosousa/git-town

Generic, high-level Git workflow support!

Git Town makes Git more efficient, especially for large teams. See this screencast for an introduction.

Commands

Git Town provides these additional Git commands:

Typical development commands

• 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

Advanced development commands

• 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

Nested feature branches

• 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-branch - updates a branch's parent

Git Town configuration

• git town config - displays or updates your Git Town configuration
• git town new-branch-push-flag - configures whether new empty branches get pushed to origin
• git town main-branch - displays or sets the main development branch for the current repo
• git town offline - enables/disables offline mode
• git town perennial-branches - displays or updates the perennial branches for the current repo
• git town pull-branch-strategy - displays or sets the strategy to update perennial branches

Git Town setup

• git town alias - adds or removes shorter aliases for Git Town commands
• git town completions - generates completion scripts for Bash, zsh, fish & PowerShell.
• git town version - displays the installed version of Git Town

Installation

See the installation and configuration instructions for more details.

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.

Kudos to our contributors!

@kevgo	@charlierudolph	@allewun	@ricmatsui	@redouglas	@allonsy	@blaggacao
@aricahunter	@jiexi	@iamandrewluca	@ChrisMM	@zhangwei	@tallpants	@seanstrom
@schneems	@morrme	@mjhm	@luketlancaster	@ecbrodie	@doismellburning	@dgjnpr
@atilacamurca	@Zearin	@TKAB	@Siilwyn	@WurmD	@sgarfinkel	@cirego
@sheldonhull	@alphatroya	@joshRpowell	@pattiereaves	@zenspider	@Iron-Ham	@grignaak
@ericyliu	@natecox	@shadowhand	@hmbrg	@qrevel	@aeneasr	@martinjaime
@alexw10	@alexdavid	@Braunson

Stargazers over time