help / color / mirror / code / Atom feed
* [ANN] git-completion 1.3 released
@ 2021-01-01  2:48 Felipe Contreras
  0 siblings, 0 replies; only message in thread
From: Felipe Contreras @ 2021-01-01  2:48 UTC (permalink / raw)
  To: zsh-users


Git-completion is a friendly fork of the official Git completion and
prompt scripts for Zsh and Bash.

The main goal is to provide a more up-to-date completion for Zsh (I'm
the developer), which is basically just a wrapper around the Bash

Compared to Git upstream, you get many benefits for Zsh, but there's
also benefits for Bash users too.

If you use the official Zsh completion, the main benefit is that it's
blazingly fast. Simply doing "git log <tab>" on the Linux kernel (with
3k+ refs) takes several seconds on the official Zsh completion (about
3 seconds on my machine), with git-complete it's *instantaneous*.

There's other benefits too. Since the Bash completion is actively
maintained by Git developers, everything works as they intend too.

For example "git send-email <tab>" correctly completes branches, as
opposed to files in the Zsh official completion. Also, complex aliases
such as '!f () { }; f' are correctly identified and completed

It's a sister project of the Oh My Zsh gitfast plugin [1], which I maintain too.

Since the last version, the baseline has been updated to git 2.30 (which
includes some of the patches of git-completion 1.2), but there's a bunch
of other improvements and fixes.

The main improvement over 1.2 is that now all the completions are
correctly quoted (according to zsh developers using compadd -Q is rarely

In total there are 47 patches [2] on top of git's master (plus tests and

For installation instructions, and more information, check the wiki
[3], but basically.

 * make install
 * fpath=(~/.local/share/git-completion/zsh $fpath)

And for Arch Linux users I've created an AUR package: [4].

Enjoy and Happy New Year!

[1] https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/gitfast
[2] https://lore.kernel.org/git/20210101021622.798041-1-felipe.contreras@gmail.com/
[3] https://github.com/felipec/git-completion/wiki/Zsh
[4] https://aur.archlinux.org/packages/git-completion/

Felipe Contreras

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2021-01-01  2:49 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-01-01  2:48 [ANN] git-completion 1.3 released Felipe Contreras

Code repositories for project(s) associated with this public inbox


This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).