ricmatsui / git-town

High-level Git workflow extensions for agile development teams

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Git Town

Build Status License

Git Town makes software development teams who use Git even more productive and happy. It adds additional 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.

Check out the big picture for more background on Git Town and the tutorial to get an idea for how it works.

Commands

Git Town provides these additional Git commands:

  • git extract - copy selected commits from the current branch into their own branch
  • git hack - cut a new feature branch off the main branch
  • git kill - remove an obsolete feature branch
  • git prune-branches - delete merged branches
  • git pull-request - create a new pull request
  • git repo - view the repository homepage
  • git ship - deliver a completed feature branch
  • git sync - update the current branch with all relevant changes
  • git sync-fork - pull upstream updates into a forked repository
  • git town - general Git Town help, view and change Git Town configuration

Installation

Git Town is written in 100% Bash, so it runs anywhere Git and Bash runs.

Using Homebrew Manually
Install
brew tap Originate/gittown
brew install git-town
  • clone the repo to your machine (into DIR)
  • add DIR/src to your $PATH
  • add DIR/man to your $MANPATH
  • install Dialog (used by git extract)
Update
brew update
brew upgrade git-town
  • run git pull in DIR
Uninstall
brew uninstall git-town
brew untap Originate/gittown
  • remove DIR
  • remove DIR/src from your $PATH
  • remove DIR/man from your $MANPATH

Optional tools that make Git Town better

  • Autocompletion for Fish shell

    $ git town install-fish-autocompletion
    

Configuration

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

Documentation

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.

Contributing

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.

About

High-level Git workflow extensions for agile development teams

License:MIT License


Languages

Language:Gherkin 84.4%Language:Shell 9.0%Language:Ruby 6.6%