faq

FAQ

What are the requirements?

• Zsh
  • zplug is known to work with Zsh 4.3.9 or above.
• Git
  • Most of the features should work with Git 1.7 or above.

Recommended

• curl/wget for getting from GitHub Releases

Why should I use zplug instead of antigen/zgen?

Well, here's why! zplug...

• can manage everything including...
  • Zsh plugins/UNIX commands on GitHub and Bitbucket
  • Gist file (gist.github.com)
  • Externally managed plugins e.g., oh-my-zsh plugins/themes
  • Binary artifacts on GitHub Releases
  • Local plugins
  • etc.
• has super-fast parallel installation/update
• can specify branch/tag/commit
• allows post-update hooks
• can express dependencies between plugins
• unlike antigen, no ZSH plugin file (*.plugin.zsh) required

• works well with interactive interface (fzf, peco, zaw, and so on)

• has cache mechanism for reducing startup time
• can add plugins from the command line (with completions *wink*) without editing .zshrc

How do I migrate from antigen?

antigen	zplug
source ~/.antigen/antigen.zsh	source ~/.zplug/zplug
antigen bundle zsh-users/zsh-syntax-highlighting	zplug zsh-users/zsh-syntax-highlighting
antigen bundle zsh-users/zsh-completions	zplug zsh-users/zsh-completions
antigen apply	zplug load

How do I migrate from zgen?

zgen	zplug
source ~/.zgen/zgen.zsh	source ~/.zplug/zplug
zgen load zsh-users/zsh-syntax-highlighting	zplug zsh-users/zsh-syntax-highlighting
zgen oh-my-zsh zgen oh-my-zsh plugins/git	zplug plugins/git, from:oh-my-zsh
zgen update	zplug update
zgen selfupdate	zplug update --self
zgen reset	zplug clear