If I do this:

alias g='git'

I loose all completion rules (i.e. branches and remotes are no longer being automatically completed when I hit TAB after typing, for example g push o).

  • While I don't have an answer for you, I'm going to have to take a minute and wonder if not typing those two other letters is really giving you much of an advantage? – Marco Ceppi Sep 19 '11 at 13:17
  • 4
    Sure it does! I'm typing 'g' probably over a 100 times a day. – Paweł Gościcki Sep 19 '11 at 13:29
  • 3
    Aliasing often-used short commands to even shorter aliases saves me hundreds of keypresses a day. According to my shell history, I have used the alias g=git 756 times in the past month, meaning I saved pressing the 'g' and 'i' keys 1512 times total. That, combined with my git aliases, probably saves me tens of thousands of key presses a month. – Smith John Dec 12 '12 at 1:56
  • The main point of shortening keystrokes is helping your hands keep up with your brain. – Tyler Collier Feb 26 '15 at 23:37
  • The script at superuser.com/questions/436314/… worked so well I think it deserves a mention. – brandizzi May 26 '16 at 14:50

Copying and modifying opportunely from /etc/bash_completion.d/git, add the following lines to your ~/.bashrc:

complete -o bashdefault -o default -o nospace -F _git g 2>/dev/null \
    || complete -o default -o nospace -F _git g
  • Ha! Wunderbar! Works just like it should :) – Paweł Gościcki Sep 19 '11 at 13:32
  • 1
    I also had to add source /usr/share/bash-completion/completions/git to my .bashrc – pcx Aug 21 '14 at 6:46
  • Not sure if the .bashrc code here works, but this answer is definitely out of date. /etc/bash_completion.d/git doesn't seem to exist on 14.04. See lzap's answer below. – Max Wallace Nov 6 '15 at 18:04

Latest bash-completion upstream moved and renamed things a bit. It's now:

source /usr/share/bash-completion/completions/git
__git_complete g __git_main

Use this in recent versions of Ubuntu (e.g. 14.04, also Fedora 22+) when you encounter:

completion: function `_git' not found

during completing.

  • 2
    Seems like this is the only correct answer here. – pjvandehaar Nov 3 '15 at 6:17
  • Use __git_complete gc _git_checkout (or similar) to set up completions for more specific aliases. Search /usr/.../git as above to find the right name. – Max Wallace Nov 6 '15 at 18:00
  • 1
    @MaxWallace - when you set the aliases for particular git methods in .gitconfig (e.g. gc = checkout), there is no need to explicitly configure completion for them. – Piotr Aleksander Chmielowski Oct 22 '16 at 7:43
  • 1
    @PiotrAleksanderChmielowski Thanks! But I don't think that works for top-level bash aliases (e.g. gc => git checkout) as opposed to aliasing c to checkout within git, and saying git c. Correct me if I'm wrong. – Max Wallace Oct 24 '16 at 12:33
  • @MaxWallace Yes, you are right, my mistake ;) – Piotr Aleksander Chmielowski Oct 24 '16 at 15:39

In ~/.bashrc:

alias g='git'
source /usr/share/bash-completion/completions/git
complete -o default -o nospace -F _git g

Via http://29a.ch/2013/8/9/fixing-bash-autocomplete-on-ubuntu-13-04


The updated way to do this (complete wouldn't work for me):

  1. cd - switch to your home directory
  2. wget https://raw.github.com/git/git/master/contrib/completion/git-completion.bash
  3. Add source ~/git-completion.bash to your .bashrc file (if you don't have this file make one in your home folder, bash will look for it automatically)
  4. Add alias g='git'to your .bashrc file.
  5. Start a new session or source your changes with source ~/.bashrc
  • 2
    You skipped the part where they actually added completion in the comment you linked to: __git_complete g _git – pjvandehaar Nov 3 '15 at 6:08

First, look up the original completion command. Example:

$ complete | grep git

complete -o bashdefault -o default -o nospace -F __git_wrap__git_main git

Now add these to your startup script (e.g. ~/.bashrc):

# copy the original statement, but replace the last command (git) with your alias (g)
complete -o bashdefault -o default -o nospace -F __git_wrap__git_main g

# load dynamically loaded completion functions (may not be required)
_completion_loader git

The _completion_loader line may not be required. But for some situations, the completion function is only loaded dynamically after you type the command and press TAB the first time. So if you haven't used the original command, and try the alias + TAB, you may get an error like "bash: completion: function not found".


Just for the sake of completeness, I'd like to add an answer using the ~/.bash-completion file, which gets sourced at the end of the bash-completion script:

_xfunc git __git_complete g __git_main
_xfunc git __git_complete gl _git_log
_xfunc git __git_complete gd _git_diff
_xfunc git __git_complete gb _git_branch

Then in my ~/.bashrc I have just the aliases. I was trying to:

  • avoid poluting my ~/.bashrc with bash-completion stuff (keep stuff where it belongs) ✓
  • avoid sourcing the whole git-completion into my shell ☹

Unforutnately the _xfunc sources the git-completion anyway. I'll update this answer once I figure out how to do it properly (I also asked on lunchpad here).


Look at here: https://gist.github.com/scue/576310b7c6b7714aad05

wget https://gist.github.com/scue/576310b7c6b7714aad05/raw/459d46761c231f5c373c1cf496920b01bb6669d2/.bash_aliases.git -O ~/.bash_aliases.git
echo "test -e ~/.bash_aliases.git && source ~/.bash_aliases.git" >> ~/.bashrc



You may just define aliases as usual:

alias g='git'

Then install complete-alias to make bash completion alias-aware.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.