+1
Daily
4,902
stars
160
forks
17
watchers
499
prs
261
issues
16
releases
README
Zinit
[![MIT License][mit-badge]][mit-link] [![zinit version][ver-badge]][ver-link] [![zunit tests][tests-badge]][tests-link]
[![Join the chat at https://matrix.to//zdharma-continuum_community:gitter.im][gitter-badge]][gitter-link]
- Zinit Wiki
- Install
- Automatic
- Manual
- Usage
- Introduction
- Plugins and snippets
- Upgrade Zinit and plugins
- Turbo and lucid
- Migration
- Frequently Asked Questions
- Use zi ice svn if a plugin/snippet requires an entire subdirectory
- Use zi ice as'completion' to directly add single file completion snippets
- More Examples
- Ice Modifiers
- Cloning Options
- Selection of Files (To Source, …)
- Conditional Loading
- Plugin Output
- Completions
- Command Execution After Cloning, Updating or Loading
- Sticky-Emulation Of Other Shells
- Others
- Order of Execution
- Zinit Commands
- Help
- Loading and Unloading
- Completions
- Tracking of the Active Session
- Reports and Statistics
- Compiling
- Other
- Updating Zinit and Plugins
- Completions
- Calling compinit Without Turbo Mode
- Calling compinit With Turbo Mode
- Ignoring Compdefs
- Disabling System-Wide compinit Call
- Ubuntu
- NixOS
- Zinit Module
- Hints and Tips
- Using ZPFX variable
- Customizing Paths
- Non-GitHub (Local) Plugins
- Extending Git
- Changelog
- Support
- Getting Help and Community
Zinit is a flexible and fast Zshell plugin manager that will allow you to install everything from GitHub and other
sites. Its characteristics are:
1. Zinit is currently the only plugin manager that provides Turbo mode, which yields 50-80% faster Zsh startup
(i.e., the shell will start up to 5 times faster!). Check out a speed comparison with other popular plugin
managers here.
2. The plugin manager gives reports from plugin loadings describing what aliases, functions, bindkeys, Zle
widgets, zstyles, completions, variables, PATH and FPATH elements a plugin has set up. This allows one to
quickly familiarize oneself with a new plugin and provides rich and easy-to-digest information which might be helpful
on various occasions.
3. Supported is the unloading of plugin and ability to list, (un)install and selectively disable, enable
plugin's completions.
4. The plugin manager supports loading plugins and libraries from Oh My Zsh or Prezto. However, the implementation isn't
framework-specific and doesn't bloat the plugin manager with such code (more on this topic can be found on the Wiki,
in the Introduction).
5. The system does not use $FPATH, loading multiple plugins doesn't clutter $FPATH with the same number of entries
(e.g. 10, 15 or more). Code is immune to KSH_ARRAYS and other options typically causing compatibility problems.
6. Zinit supports special, dedicated packages that offload the user from providing long and complex commands. See
the zinit-packages repository for a growing, complete list of
Zinit packages and the Wiki page forTop issues
#362[bug]: Constant CPU usage19 comments · 2022-08-19#129[bug]: `mv` ice does not rename file on initial run19 comments · 2021-12-06#437[feat]: refactor function names13 comments · 2022-12-09#418[bug]: cannot stat 'path/to/zinit/doc/zinit.1'13 comments · 2022-11-08#73Support 'unar' instead of requiring various unpackers (e.g. xz)12 comments · 2021-11-18#504[feat]: remove `subversion` dependency11 comments · 2023-04-15#467[bug]: no hook for hook:!atpull-* works 10 comments · 2023-01-27#178feature: Use a GitHub CDN for Zinit downloads10 comments · 2022-02-08
Discussions
#803Generated completions that behave like ordinary plugins: null + id-as + atclone/atpull0 comments · 2026-08-10#784How to handle .zst files1 comments · 2026-06-16#782ccline — zsh companion: ask your shell about plugins/configs in plain English0 comments · 2026-06-10#758[bug]: Git branch completions not working1 comments · 2026-01-23#756Need help with OMZ git completions1 comments · 2026-01-16#754New Annex to Source the Latest Release of a GitHub Project2 comments · 2026-01-01#745Issues when downloading snippets with OMZP:0 comments · 2025-10-28#725zsh compinit: insecure directories ... for root only0 comments · 2025-06-24
Latest release
v3.17.1 v3.17.1 2026-10-10What's Changed fix(completion): add missing _zinit_ handlers, drop orphans, fix labels by @HaleTom in https://github.com/zdharma-continuum/zinit/pull/822 fix(completion): balance paren and escape $PATH in snippet --command spec by @HaleTom in https://github.com/zdharma-continuum/zinit/pull/821 Fix typo "direcorty" - "directory" by @the-can-of-soup in https://github.com/zdharma-continuum/zinit/pull/825 test(gh-r): replace skipped zed test with super by @vladdoster in https://github.com/zdharma-continuum/zinit/pull/832 test(snippets): update brew-completion path to use main branch by