# zsh-completions

![GitHub release](https://img.shields.io/github/release/zsh-users/zsh-completions.svg)
![Contributors](https://img.shields.io/github/contributors/zsh-users/zsh-completions.svg)
[![IRC](https://img.shields.io/badge/IRC-%23zsh--completions-yellow.svg)](irc://irc.freenode.net/#zsh-completions)
[![Gitter](https://badges.gitter.im/zsh-users/zsh-completions.svg)](https://gitter.im/zsh-users/zsh-completions?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)

**Additional completion definitions for [Zsh](https://www.zsh.org/).**

This project provides new, extended, or missing completion scripts that are not yet available in Zsh.  
Once stable, these completions may be contributed to the official Zsh project.

---

## 📦 Installation

### Using distribution packages

| OS / Distribution | Package Link |
|------------------|--------------|
| **Debian / Ubuntu** | [OBS Repository](https://software.opensuse.org/download.html?project=shells:zsh-users:zsh-completions&package=zsh-completions) |
| **Fedora / CentOS / RHEL** | [OBS Repository](https://software.opensuse.org/download.html?project=shells:zsh-users:zsh-completions&package=zsh-completions) |
| **openSUSE / SLE** | [OBS Repository](https://software.opensuse.org/download.html?project=shells:zsh-users:zsh-completions&package=zsh-completions) |
| **Arch / Manjaro** | [zsh-completions](https://archlinux.org/packages/zsh-completions) / [zsh-completions-git](https://aur.archlinux.org/packages/zsh-completions-git) |
| **Gentoo / Funtoo** | [app-shells/zsh-completions](https://packages.gentoo.org/packages/app-shells/zsh-completions) |
| **NixOS** | [Package](https://github.com/NixOS/nixpkgs/blob/master/pkgs/shells/zsh/zsh-completions/default.nix) |
| **Void Linux** | [Template](https://github.com/void-linux/void-packages/blob/master/srcpkgs/zsh-completions/template) |
| **Slackware** | [SlackBuilds](https://slackbuilds.org/repository/14.2/system/zsh-completions/) |
| **macOS** | [Homebrew](https://github.com/Homebrew/homebrew-core/blob/master/Formula/z/zsh-completions.rb), [MacPorts](https://github.com/macports/macports-ports/blob/master/sysutils/zsh-completions/Portfile) |
| **NetBSD** | [pkgsrc](https://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc/shells/zsh-completions/README.html) |
| **FreeBSD** | [shells/zsh-completions](https://www.freshports.org/shells/zsh-completions) |

---

## 🧩 Using Zsh Frameworks

### **Antigen**
```zsh
antigen bundle zsh-users/zsh-completions
Improve README formatting, installation instructions, and structure