xinb
/
zsh-completions
mirror of https://github.com/zsh-users/zsh-completions.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Additional completion definitions for Zsh.
2,465 Commits 1 Branch 40 Tags 6.9 MiB
Shell 94.7%
Python 4.3%
Emacs Lisp 1%
Go to file
hetaaaaaaaansh af1db4e3c9 cmake: suggest -D arguments required by --find-package 
--find-package (cmake's legacy pkg-config-like mode) silently requires
-DNAME=, -DLANGUAGE=, -DCOMPILER_ID= and -DMODE= to be set, or cmake
aborts with a chain of 'argument not specified' errors (see
Modules/CMakeFindPackageMode.cmake). The completion script gave no
hint that these were needed.

Detect --find-package on the command line and, when present, offer
NAME/LANGUAGE/COMPILER_ID/MODE alongside the usual -D property names,
plus value completion for each (e.g. LANGUAGE -> C/CXX/Fortran,
MODE -> EXIST/COMPILE/LINK).

Fixes #593
 		2026-08-16 18:08:32 +05:30
.github Remove empty issue template 2025-03-12 19:39:41 +09:00
src cmake: suggest -D arguments required by --find-package 2026-08-16 18:08:32 +05:30
.editorconfig Update links 2022-11-23 13:31:48 +09:00
.gitignore git ignore some IDE files 2018-11-04 14:27:35 +01:00
CONTRIBUTING.md Fix typos 2020-04-09 11:51:09 +03:00
LICENSE Change default license to the Zsh license (as discussed on zsh-workers mailing-list) 2017-10-19 19:54:32 +02:00
README.md Fix link rot for NixOS package 2026-03-24 16:24:45 -04:00
zsh-completions-howto.org docs: clarify _regex_arguments example explanation (#1106) 2026-05-21 12:12:35 -05:00
zsh-completions.plugin.zsh fix: entrypoint fpath expansion 2021-12-01 12:08:52 +06:00

README.md

zsh-completions GitHub release GitHub contributors IRC Gitter

Additional completion definitions for Zsh.

This project aims at gathering/developing new completion scripts that are not available in Zsh yet. The scripts may be contributed to the Zsh project when stable enough.

Usage

Using packages

System Package
Debian / Ubuntu zsh-completions OBS repository
Fedora / CentOS / RHEL / Scientific Linux zsh-completions OBS repository
OpenSUSE / SLE zsh-completions OBS repository
Arch Linux / Manjaro / Antergos / Hyperbola zsh-completions, zsh-completions-git
Gentoo / Funtoo app-shells/zsh-completions
NixOS zsh-completions
Void Linux zsh-completions
Slackware Slackbuilds
macOS homebrew, MacPorts
NetBSD pkgsrc
FreeBSD shells/zsh-completions

Using zsh frameworks

antigen

Add antigen bundle zsh-users/zsh-completions to your ~/.zshrc.

oh-my-zsh

To avoid issues with redundant .zcompdump cache generation (see #603), do not load zsh-completions as a standard plugin.
Instead, follow this optimized approach:

  1. Clone the repository into your custom plugins directory:
git clone https://github.com/zsh-users/zsh-completions.git \
  ${ZSH_CUSTOM:-${ZSH:-~/.oh-my-zsh}/custom}/plugins/zsh-completions
  1. Update your ~/.zshrc configuration before sourcing oh-my-zsh:
fpath+=${ZSH_CUSTOM:-${ZSH:-~/.oh-my-zsh}/custom}/plugins/zsh-completions/src
autoload -U compinit && compinit
source "$ZSH/oh-my-zsh.sh"

This prevents compinit from being called twice and significantly improves shell startup time.

zinit

Add zinit light zsh-users/zsh-completions to your ~/.zshrc.

Manual installation

  • Clone the repository:
git clone https://github.com/zsh-users/zsh-completions.git
  • Include the directory in your $fpath, for example by adding in ~/.zshrc:
fpath=(path/to/zsh-completions/src $fpath)
  • You may have to force rebuild zcompdump:
rm -f ~/.zcompdump; compinit

Contributing

Contributions are welcome, see CONTRIBUTING.

License

Completions use the Zsh license, unless explicitly mentioned in the file header.
See LICENSE for more information.