Homebrew’s `git` not using completion

Question

When using OSX’s git, after I modify a file I can simply do git commit <tab>, and that’ll auto complete the file’s name to the one that was modified. However, if I install a newer version of git from homebrew and I use it, that feature no longer works (meaning I press <tab> and it just “asks” me what file I want to do it on, even including the ones that have no changes).

Can anyone shed some light as to why, and how to solve that? I’d prefer using homebrew’s git, since it’s more up-to-date.

My shell is zsh, and Neither installing bash-completion or zsh-completions worked (even after following homebrew’s post-install instructions).

Also, after installing git with homebrew it says

Bash completion has been installed to: /usr/local/etc/bash_completion.d
zsh completion has been installed to: /usr/local/share/zsh/site-functions

So shouldn’t I be able to use one of those?

Do other `git` completions work (`git co` ==> `git commit`, for example)? — simont, Feb 28 '13 at 05:44
I suspect a few different issues end up here, but installing git via brew fixed this for me. Seems `zsh-completions` wasn't happy with the mac git, though it worked fine before (possibly updated blindly to 0.17.x). — ti7, Apr 20 '16 at 16:11

score 301 · Accepted Answer · edited Jan 31 '19 at 06:03

301

You're looking for:

brew install git bash-completion

As warpc's comment states, you'll need to add the following to your ~/.bash_profile to get homebrew's bash-completion working:

if [ -f $(brew --prefix)/etc/bash_completion ]; then
    . $(brew --prefix)/etc/bash_completion
fi

The above is mentioned in the caveats when you install the bash-completion formula.

Note: if you are using Bash v4 or later (via brew install bash) then you're going to want to use brew install bash-completion@2, to enable tab completion add the following to ~/.bash_profile as described in the caveats:

export BASH_COMPLETION_COMPAT_DIR="/usr/local/etc/bash_completion.d"
[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"

The additional export is necessary for git, docker, youtube-dl, and other completions which may be included in the $(brew --prefix)/etc/bash_completion.d/ directory.

edited Jan 31 '19 at 06:03

Corey Gouker

3
1
4

answered Feb 20 '13 at 01:47

Graham Perks

21,623
8
56
79

3

My shell is zsh. Does that mean I should do `brew install git zsh-completions`? Also, after installing git with homebrew it says `Bash completion has been installed to: /usr/local/etc/bash_completion.d zsh completion has been installed to: /usr/local/share/zsh/site-functions`, so couldn't I use one of those? – user137369 Feb 20 '13 at 02:17
2

Neither installing `bash-completion` or `zsh-completions` worked (even after following homebrew's instructions after install). – user137369 Feb 20 '13 at 03:59
Did you restart your terminal? – Graham Perks Feb 20 '13 at 15:46
12

Did you also add in ~/.bash_profile for bash case this content: if [ -f $(brew --prefix)/etc/bash_completion ]; then . $(brew --prefix)/etc/bash_completion fi – warpc Aug 20 '13 at 06:23
5

I have already installed git without brew. Now I want to install bash_completion using brew. I ran brew install bash-completion and added above code but no luck – MagePsycho Sep 03 '14 at 06:35
I'm confused by the mention of bash-completion here, because bash-completion does not provide [git-completion](https://github.com/git/git/blob/master/contrib/completion/git-completion.bash). Perhaps people with unsolved problems could try adding it manually? – Sam Jul 23 '15 at 01:15
For git completion to work, per https://github.com/git/git/blob/master/contrib/completion/git-completion.bash , `. ~/bin/git-completion.bash` is also needed. So (using a semi-colon where this comment format removes line breaks): ``` if [ -f $(brew --prefix)/etc/bash_completion ]; then . $(brew --prefix)/etc/bash_completion fi; . ~/bin/git-completion.bash ``` – christopherbalz Sep 03 '15 at 02:07
@christopherbalz git-completion.bash is automatically included, since it's in /usr/local/etc/bash_completion.d. Everything in bash_completion.d gets loaded by the bash_completion script (you can verify this by searching the script for BASH_COMPLETION_DIR). – Graham Perks Sep 03 '15 at 15:44
1

@MagePsycho Any luck in your case ? I am facing the similar scenario atm. Any help in this regard? – Vyper May 31 '16 at 09:55
@vyper did you 'source ~/.bash_profile' after adding the extra line? (Or kill and re-open your Terminal) – Graham Perks May 31 '16 at 14:16
1

@GrahamPerks yup tried both the things. The problem is i am using Apple's git that comes default with osx and i am using brew bash completion. And due to some weird reason brew bash completion aint working with Apple git. – Vyper May 31 '16 at 22:28
On the contrary curl https://raw.githubusercontent.com/git/git/master/contrib/completion/git-completion.bash -o ~/.git-completion.bash && echo "source ~/.git-completion.bash" >> ~/.bash_profile && source ~/.bash_profile this actually worked for me. I have no clue what extra bash completion provides with git-completion.bash doesn't provide. – Vyper Jun 01 '16 at 08:30
I was scratching my head until I realised it's git bash-completion, not just bash-completion. – Chucky Oct 13 '17 at 11:02
3

It's worth noting that installing git through brew is essential for this to work. I had not known that the apples version of git was part of the problem. I downvoted this answer before I knew that and now I can't upvote :( – Reimus Klinsman Sep 26 '19 at 23:53
`brew install git bash-completion` does not work. It took 10 to 15 minutes for it to download and compile on my Mac using all cores to do so! Result: completion still does not work. Further, the installation broke my prompt's usage of `__git_ps1`, with the result: `-bash: /usr/local/etc/bash_completion.d/git-prompt.sh: No such file or directory` Now I have to go fix everything it messed up. – Jason Doucette Nov 13 '19 at 21:43
i found the solution [link](https://stackoverflow.com/a/58517668/4576242) here – Kostas Raptis Jan 30 '21 at 01:13

user2347638 · Answer 2 · 2021-02-08T22:03:25.093

118

This get's git tab completion working on OSX without having to restart your terminal:

curl https://raw.githubusercontent.com/git/git/master/contrib/completion/git-completion.bash -o ~/.git-completion.bash
echo "source ~/.git-completion.bash" >> ~/.bash_profile
source ~/.bash_profile

EDIT: this doesn't work in Catalina's default zsh shell. I changed the default shell back to bash and it works again. https://www.howtogeek.com/444596/how-to-change-the-default-shell-to-bash-in-macos-catalina/

edited Feb 08 '21 at 22:03

answered Jan 24 '15 at 19:25

user2347638

1,291
1
8
5

14

It’s a bit of a cheat to call it a one-liner when using `&&`. Any bash script could be a one-liner like that. – user137369 Jan 24 '15 at 23:24
1

You are the true MVP! – heez Nov 02 '16 at 15:06
2

Definitely better than `brew install` method. Simply because it works. – dchayka Apr 11 '17 at 04:11
2

Been searching for hours on a solution to as to why bash wasn't picking up the git-completion commands. Finally, this worked! Thank you so much! – TheAmazingKnight Jan 17 '18 at 01:32
If you're like me who tried to install git autocomplete through Homebrew many times over the course of months with no success, this is the light. – Hans Mar 11 '18 at 00:32
1

This is the actual solution more easy – Rigin Oommen May 14 '18 at 15:23
Works like charm! Thanks – Amitrajit Bose Mar 29 '20 at 18:18
HOURS of trying to fix the Homebrew stuff on Catalina, looked at this and thought, PFFFFFF, yeah right! BUT IT WORKED! No idea why, already did 12 things like it, but this just worked. Oh well... DO IT!!! (Also, thanks!!! :D) – Resist Design Sep 14 '20 at 20:11
HEADS UP: if you're new at this stuff... make DANG SURE you have 2 of these `>>` because just 1 would overwrite your whole `~/.bash_profile` and that's not great :P – Resist Design Sep 14 '20 at 20:14

score 23 · Answer 3 · answered Dec 20 '16 at 21:00

23

In case anyone else makes my dumb mistake, try brew install git. I was using the git that comes with Xcode and didn't realize that I had never installed Homebrew's git to get the autocompletions.

answered Dec 20 '16 at 21:00

Harvey

5,267
1
28
36

score 19 · Answer 4 · answered Jul 02 '14 at 11:50

19

for some reason I was missing the file at $(brew --prefix)/etc/bash_completion so @Graham Perks' correct answer didn't work for me

It ended up the fix in my case was:

brew unlink bash-completion
brew link bash-completion

answered Jul 02 '14 at 11:50

Anentropic

26,635
9
86
130

After following @Graham Pixel's answer, this finally made it wok for me. – Luke Jul 14 '15 at 06:37
This also just worked for me with Homebrew 1.6.0, git 2.17.0 (hub 2.2.9), and bash-completion 1.3 on OS X Sierra 10.12.6. – jared Apr 11 '18 at 00:38

score 11 · Answer 5 · answered Aug 18 '15 at 22:33

11

I solved the problem by figuring out that $(brew --prefix)/etc/bash_completion returned Permission denied when executed. So after a simple:

chmod +x $(brew --prefix)/etc/bash_completion

Everything is now working fine. I'm wondering why Homebrew doesn't make the bash_completion file executable on installation, though.

answered Aug 18 '15 at 22:33

Asbjørn Ulsberg

8,212
2
41
60

5

No, this is wrong. `bash_completion` is meant to be `source`'d so the definitions are in your shell; executing will have no effect. – toddkaufmann Sep 17 '17 at 14:25

score 5 · Answer 6 · edited Sep 01 '14 at 06:15

5

I had the same issue and even found this post this morning. I fixed the issue by updating brew with brew update and then reinstalling git with brew reinstall git.

I was then notified of another file that is blocking the homebrew linking process, in my case it was /usr/local/share/zsh/site-functions/git-completion.bash. Removing the file and running brew link git solved the issue. Guessing it was just a bad recipe version we stumbled upon.

edited Sep 01 '14 at 06:15

potashin

42,140
11
76
100

answered Mar 02 '13 at 16:34

Jonathan Knapp

51
2

1

You'll also notice the version of git you are using is Apple's and not the version installed by Homebrew. At least in my case I did. You can check the version with `git --version` – Jonathan Knapp Mar 02 '13 at 16:36
Nope. That still does not work for me. I've always gotten back to using OSX's git, that completion is just too big a feature to let go. – user137369 Mar 02 '13 at 20:51
git-completion stopped working for me after update to Mavericks. I had to `brew reinstall git` and also `brew reinstall bash-completion` to make it work again. – Krešimir Nesek Jun 05 '14 at 11:06

score 5 · Answer 7 · answered Mar 02 '13 at 21:09

5

Found a working solution. It's very recent (authored 16 hours ago, and committed 2 hours ago), and it comes directly from homebrew.

brew install git --without-completions

Just tried it, and it finally works as intended.

answered Mar 02 '13 at 21:09

user137369

4,260
5
25
49

3

I don't see how installing `git` without completion could improve the situation of completion not working. I believe Graham Perks' answer http://stackoverflow.com/a/14970926/1199564 should be flagged as the correct answer. – mgd Sep 01 '13 at 13:37
I had a similar issue and I've solved reinstalling `git --without-completions` and sourcing the `bash-completion.bash` file from `.bash_profile` that most probably is overridden following the standard procedure. – Leonardo Oct 28 '13 at 23:09
1

This is not a correct answer. @graham perks's answer is correct. – CantGetANick Nov 12 '13 at 10:26
@CantGetANick Graham’s answer did not solve my issue, this did, that’s I why I marked it. – user137369 Nov 12 '13 at 23:45
1

Agree 100% with user137369: I already had homebrew's bash-completion package installed so @graham's answer couldn't possibly work for me. However, `brew install git` fixed everything (no need for --without-completions). I think this is also a correct answer. – bronson Dec 05 '13 at 00:53
This answer needs some more explaining, how can completion work if you install it without? – softarn Apr 02 '14 at 13:48
Seeing as `brew install git` now works without the need for either this or @Graham Perk’s solution, I’ll mark his as accepted, instead. It was likely some issue at the time that has since been resolved. – user137369 Apr 02 '14 at 21:13

dlamblin · Answer 8 · 2018-03-09T08:39:00.937

If you have $BASH_VERSION < 4.1, eg 3.2.57(1)-release then go ahead with:

brew install bash-completion
# In ~/.bash_profile :
if [ -f $(brew --prefix)/etc/bash_completion ]; then
    . $(brew --prefix)/etc/bash_completion
fi

However if you've brew install bash to get version 4.4.12(1)-release you can use the better and more complete completions in:

brew install bash-completion@2
# In ~/.bash_profile:
[ -f "$(brew --prefix)/share/bash-completion/bash_completion" ] \
&& . "$(brew --prefix)/share/bash-completion/bash_completion"

Note that some packages (brew, docker, tmux) will still put some completions into $(brew --prefix)/etc/bash_completion.d/ so you might add:

for completion in "$(brew --prefix)/etc/bash_completion.d/"*
do
    . $completion
done

Finally you should be able to add the git completion script if for some reason the way you installed git did not add it to either of those:

[[ -f $(brew --prefix)/etc/bash_completion.d/git \
|| -f $(brew --prefix)/share/bash-completion/completions/git ]] \
|| curl https://raw.githubusercontent.com/git/git/master/contrib/completion/git-completion.bash \
    -o $(brew --prefix)/etc/bash_completion.d/git

You can get and add it with the above.

Feuda · Answer 9 · 2019-08-23T09:12:55.107

Step 1: Download auto completion script:

cd ~
curl -O https://raw.githubusercontent.com/git/git/master/contrib/completion/git-completion.bash

Step 2: Update .bash_profile and .bashrc

echo "source ~/git-completion.bash" >> .bash_profile

Via https://www.anintegratedworld.com/git-tab-autocomplete-on-osx-10-11-el-capitan/

If above does not work, try https://github.com/bobthecow/git-flow-completion/wiki/Install-Bash-git-completion

cgons · Answer 10 · 2019-10-09T17:36:50.520

In 2019, using Bash v5, you do not need to explicitly source the git bash completion script in your .bash_profile or .bashrc

Ensure you have the following two lines in your .bashrc

export BASH_COMPLETION_COMPAT_DIR="/usr/local/etc/bash_completion.d"
[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"

Download the git bash completion script (https://raw.githubusercontent.com/git/git/master/contrib/completion/git-completion.bash) and save it to /usr/local/etc/bash_completion.d/ as git

That's it! Bash will automatically pick up the git completion file and enable completion.

Side Note: I recommend putting all these changes in .bashrc as this ensures that when you drop into an interactive shell (ie. from pipenv shell), completions will get loaded correctly as bash will source .bashrc and NOT .bash_profile.

score 1 · Answer 11 · answered Oct 30 '17 at 14:13

For me , I had to put

source $(brew --prefix)/etc/bash_completion

into .bashrc (not .bash_profile) to get this to work.

".bash_profile is executed for login shells, while .bashrc is executed for interactive non-login shells" -- from What is the difference between .bash_profile and .bashrc? It appears to me that MacOS Sierra doesn't execute .bash_profile when opening a new terminal window, only .bashrc.

I wouldn't put it in _bash_profile, because then I'd have to reboot/logout for updates to take effect.

score 1 · Answer 12 · answered Nov 07 '18 at 19:12

1

This worked for me in Mojave (OSX 10.14.1):

brew install bash-completion

Then add the following line to your ~/.bash_profile:

[ -f /usr/local/etc/bash_completion ] && . /usr/local/etc/bash_completion

answered Nov 07 '18 at 19:12

ar31an

163
1
9

It just multiplies the number of warnings – Hussain Akram Sep 27 '19 at 11:00

PatKilg · Answer 13 · 2021-03-30T16:14:12.107

For bash on macOS Catalina (3/30 update: Big Sur too), if you want to also use Bash 5 from homebrew, you need to make sure that your login shell is set to homebrew's bash, and not the default.

To check if you need to do this, run echo ${BASH_VERSION}. If you see a version starting with 3, you are not using Brew's bash for your login shell.

To change this,

Open System Preferences->Users and Groups.
Right click your user and select "Advanced Options". You may need to unlock this with your password by clicking the lock in the bottom left.
Set the login shell field to the location of your brew's bash, which you can usually find by running which bash in a terminal after you install brew's bash. Mine was /usr/local/bin/bash.

Restart your terminal, and follow the instructions in this excellent answer

I caution you to not change your user default login shell. Why? If you set your login shell to a "custom" install via any tool -- e.g. Homebrew, you risk breaking your default terminal if/when you uninstall or are reinstalling Homebrew or other said tool. It is much better to use an alternate terminal such as iTerm2 and set your custom login shell for that tool only. This way when you have an issue you can fall back to the system default Terminal and user shell. — Mark, May 02 '21 at 12:42

score 0 · Answer 14 · answered Feb 20 '13 at 01:41

0

It may have something to do with libedit being used instead of readline in Lion.

Try installing readline before git.

brew install readline

answered Feb 20 '13 at 01:41

Alex

2,260
2
19
17

score 0 · Answer 15 · answered May 14 '17 at 12:21

For those who already have brew bash-completion installed. I did not have the git completion script installed and could not find any tap for that.

So I added it manually:

curl https://raw.githubusercontent.com/git/git/master/contrib/completion/git-completion.bash -o $(brew --prefix)/etc/bash_completion.d/git

Note that you have to rename the file and remove the extension for it to work.

If you do not have completion or git installed, install it in the accepted answer.

brew install git bash-completion

score 0 · Answer 16 · answered Dec 24 '18 at 17:00

If you used homebrew to install git, then probably there is no need to install anything to support git completion. "git-completion.bash" file is somewhere (mine was here: /usr/local/git/contrib/completion/git-completion.bash)

All you need to do is to find the file: sudo find / -type f -name "git-completion.bash"

Then source its path in your .bash_profile. For example I needed to add this line to my ~/.bash_profile:

source /usr/local/git/contrib/completion/git-completion.bash

Don't forget to source your ~/.bash_profile or reopen your terminal ;)

from: how-enable-git-tab-completion-bash-mac-os-x

@user137369 it does - cause here you do not need to install stuff that was already installed... — Dozon Higgs, Jan 01 '19 at 06:46

score 0 · Answer 17 · answered May 13 '19 at 17:02

I know this is an old post, but you don't really need to install any additional packages.

Homebrew is informing you that there is a directory with all the stuff you need.

You can simply add the following line to your .bash_profile if you are using Bash:

source /usr/local/etc/bash_completion.d/git-completion.bash

score -1 · Answer 18 · answered Jan 05 '19 at 20:50

Enable Auto Completion of GIT commands on MAC-OS Mojave 10.14 I am a developer and use GIT from the command line all of the time. When I consider the development perspective, I used to execute a lot of commands using the command line for GIT operations. Most of the time it is very annoying that MAC OS doesn't have automatic support for the command completion which I partially support. as well as the command suggestions, which means what are the commands available for typed characters. So it is very troublesome to type very long command and mostly repetitive task as typo going wrong. :(

Tab completion would certainly be faster and easier. Unfortunately, the default installation of git on some Mac computers doesn't have tab completion enabled.

So that I was searching for a fix for the problem and there are several solutions found from the web search such as StackOverflow, GitHub as well as from the medium. Unfortunately, those solutions did not work for me and got frustrated with trying different solutions so many times.

I was searching deeply and trying out different solutions and fortunately, it is an easy fix. Below are the steps I have collected from several posts and finally it worked as expected. So I hope to share with others who have this problem like me.

f you go to the web search and you can find many solutions which mentioned the git completion bash file. Even GitHub guide as well. But I suggest you check first if the git-completion.bash file is already in your MAC computer with the git-core or something else which came from installation. you can use below command.

sudo find / -type f -name "git-completion.bash"

you will get below results. (may have some difference according to the content)

/Library/Developer/CommandLineTools/usr/share/git-core/git-completion.bash
/Users/Dilanka/git-completion.bash
/Users/Dilanka/.oh-my-zsh/plugins/gitfast/git-completion.bash
/Users/Dilanka/Downloads/git-completion.bash

I suggest you to pick which installed from git-core

If the git-completion.bash script doesn't exist on your machine, please retrieve it from the below provided above and save it to your local machine in a new file called git-completion.bash in the /usr/local/etc/bash_completion.d/ directory.

https://git-scm.com/book/en/v1/Git-Basics-Tips-and-Tricks

If you use the Bash shell, Git comes with a nice auto-completion script you can enable. Download it directly from the Git source code at

https://github.com/git/git/blob/master/contrib/completion/git-completion.bash

If the git-completion.bash script exists on your machine, but is not in the /usr/local/etc/bash_completion.d/ directory, you should create that directory and copy the file into it. Below command will do the job:

sudo mkdir /opt/local/etc/bash_completion.d
sudo cp /Library/Developer/CommandLineTools/usr/share/git-core/git-completion.bash /usr/local/etc/bash_completion.d/git-completion.bash

After the completion of above. The git-completion.bash script should exist on your local machine in the/usr/local/etc/bash_completion.d/ directory.

Now you need to refresh your profile using below command. It will load your added bash file to the terminal context.

source ~/.bash_profile

Great!!! you have done it. Just start the terminal window and try it. Just type "git sta" it will show suggestions as below:

git sta
stage    stash    status
git chec<TAB> will show git checkout

see my GitHub post here:

https://github.com/DIL8654/Enable-Auto-Completion-of-GIT-commads-on-MAC-OS-Mojave

See my Medium post here:

https://medium.com/@dilanka85/enable-auto-completion-of-git-commands-on-mac-os-mojave-10-14

Homebrew’s `git` not using completion

18 Answers18

Linked