Pimp your git workflow. Just type pull, branch, merge, push
Switch branches/tags
Nothing to show
Pull request Compare This branch is 72 commits behind jamiew:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



git-friendly is a collection of shell scripts for automating common git workflows. The goal is to make pulling, branching, and merging fast and painless.

Git is super powerful but often requires typing 2 or 3 commands just to do some super basic tasks. This package adds some new commands:
`pull, push, branch, merge` — which are just wrappers around a few underlying git commands and callbacks.

Includes bonus niceties like:

  • push also copies a GitHub compare URL to your clipboard for easy pasting (!)
  • pull will run commands like `bundle install` and `npm install` if applicable
  • branch will setup both local & remote branches as needed
  • relevant commands will stash/pop changes as needed
  • less time fighting git = more time actually doing work


Run this one-liner, which will checkout the latest code & unpack the scripts into /usr/local/bin
If you don’t have write access to /usr/local/bin you’ll need to run this using ‘sudo’

bash < <( curl https://raw.github.com/jamiew/git-friendly/master/install.sh)

You can also provide a directory to install as an argument, e.g. /usr/bin instead of /usr/local/bin:

bash < <( curl https://raw.github.com/jamiew/git-friendly/master/install.sh /usr/bin)

Advanced Install

Checkout the code:

git clone git://github.com/jamiew/git-friendly.git ~/dev/git-friendly

Then add this directory to your PATH:

export PATH=~/dev/git-friendly:$PATH

Add the above to your ~/.bash_profile or ~/.bashrc so that it runs each time you launch a new terminal.


You now have some awesome new commands available: pull, push, branch, merge

Example session:

$ pull
$ branch awesomeness
$ echo "BUMP" >> README
$ git commit -a -m "Righteous bump"
$ branch master
$ merge awesomeness
$ push


pull Stash any local changes, pull from remote using rebase, updates submodules, pop your stash, then run `bundle install` and/or `npm install` if necessary
push Push your changes to the remote + copy a sexy diff URL like http://github.com/jamiew/git-friendly/compare/e96033…5daed4 to your clipboard (works on Mac and Linux)
branch [name] Switch branches or create new local branch if it doesn’t exist. Intelligently sets up remote branch tracking so you can just type ‘git pull’ and not always ‘git pull origin newbranch’. If no argument specified will list all local and remote branches.
merge [name] Merge the specified branch into the current branch. Rebases first if the branch is local-only

Bonus: Pimp Your Configs

I strongly recommend editing your global ~/.gitconfig and adding chill features like ANSI color, command aliases (e.g. “git st” instead of “git status”), automatic remote tracking and more. Check out my ~/.gitconfig to get started.

I also recommend adding the current git branch to your Terminal prompt (PS1) or you’ll quickly lose your place — here is my pimp_prompt() bash function which goes in your ~/.bash_profile or ~/.bashrc, then type source ~/.bashrc to reload.


Code released under an MIT license.

Fork away, do whatever. Pull requests welcome!