•Can manage everything

•Super-fast parallel installation/update

•Support for lazy-loading

•Branch/tag/commit support

•Post-update, post-load hooks

•Dependencies between packages

•Unlike antigen, no ZSH plugin file (*.plugin.zsh) required

•Interactive interface (fzf, peco, zaw, and so on)

•Cache mechanism for reducing the startup time

Print the synopsis and a list of all available commands.

Print zplug’s version.

Show the error log.

Check whether there is at least one item that’s not installed. If package (username/reponame) is given, check if package is installed. If the --verbose option is given, print extra debugging information.

Remove unused packages that are in $ZPLUG_HOME/repos after showing a yes/no prompt. If package is given, uninstall that particular package. If --force option is given, suppress the prompt and uninstall package. If the --select option is given, by using the filter specified in $ZPLUG_FILTER, interactively select the package you want to uninstall.

Remove the cache file.

Install package.

List installed packages. --select do the same as what’s described above.

Load packages. All packages registered with as:plugin are sourced into the current zsh process, and its parent directory is added to $fpath. In addition, all packages with as:command are linked to $ZPLUG_HOME/bin and the bin directory is added to $PATH. --verbose does the same as what’s described above.

Show the information such as source URL and tag values of the package.

Fetch the newest version of the installed packages by zplug. --select does the same as what’s described above.

Update package. If no package is given, updates all registered packages. --select does the same as what’s described above.

Defaults to ~/.zplug. zplug will store/load plugins in this directory. The directory structure is below.

$ZPLUG_HOME
|-- bin
|   `-- some_command -> ../repos/username_A/reponame1/some_command
`-- repos
    |-- username_A
    |   |-- reponame1
    |   |   |-- README.md
    |   |   `-- some_command
    |   `-- reponame2
    |       |-- README.md
    |       `-- some_plugin.zsh
    `-- username_B
        `-- reponame1

The maximum number of threads zplug should use when installing/updating. The default value is 16.

Defaults to HTTPS. Valid options for $ZPLUG_PROTOCOL are HTTPS or SSH. Unless you have a specific reason, you should use the HTTPS protocol. For more information, see also Which remote URL should I use? - GitHub Help

Defaults to fzf-tmux:fzf:peco:percol:zaw. When --select option is specified in a subcommand, starting from the first element of the colon-separated list, whatever filter found will be used by zplug as the interactive filter. The ZPLUG_FILTER also accepts arguments (e.g. fzf-tmux -d "10%":/path/to/peco:my peco).

Defaults to $ZPLUG_HOME/packages.zsh. This file is used to add packages from zplug on the command-line. This is a useful feature when you want to isolate your zplug configurations from your .zshrc. Note that you don’t need to add packages from the command line to use this feature: you can manually edit this file, and it’ll work just fine!

Defaults to true. If this variable is true, zplug uses a cache file to speed up the loading process. The cache file is located at $ZPLUG_CACHE_DIR ($ZPLUG_HOME/.cache by default). If you want to clear the cache, please run zplug clear or do the following:

$ ZPLUG_USE_CACHE=false zplug load

Defaults to $ZPLUG_HOME/.cache. Specifies where to save the cache. For example, you can set this to $HOME/.cache/zplug to follow XDG Base Directory Specification

Defaults to $ZPLUG_HOME/repos. You can change where the repositories are cloned in case you want to manage them separately.

Defaults to ´´. You can set sudo password for zplug’s hook-build tag. However, this variable shoud not be managed in dotfiles and so on.

# your .zshrc
source ~/.zshrc_secret
zplug "some/command", hook-build:"make && sudo make install"

1.Register packages with the zplug command (zplug "username/reponame")

2. zplug load to source the plugins and add its commands to your $PATH

source ~/.zplug/zplug
# Make sure you use double quotes
zplug "zsh-users/zsh-history-substring-search"
# Can manage a plugin as a command
# And accept glob patterns (e.g., brace, wildcard, ...)
zplug "Jxck/dotfiles", as:command, use:"bin/{histuniq,color}"
# Can manage everything e.g., other person´s zshrc
zplug "tcnksm/docker-alias", use:zshrc
# Prohibit updates to a plugin by using the "frozen:" tag
zplug "k4rthik/git-cal", as:command, frozen:1
# Grab binaries from GitHub Releases
# and rename using the "rename-to:" tag
zplug "junegunn/fzf-bin", \
    as:command, \
    from:gh-r, \
    rename-to:fzf, \
    use:"*darwin*amd64*"
# Support oh-my-zsh plugins and the like
zplug "plugins/git",   from:oh-my-zsh, if:"(( $+commands[git] ))"
zplug "themes/duellj", from:oh-my-zsh, as:theme
zplug "lib/clipboard", from:oh-my-zsh, if:"[[ $OSTYPE == *darwin* ]]"
# Also supports prezto plugins
zplug "modules/osx", from:prezto, if:"[[ $OSTYPE == *darwin* ]]"
zplug "modules/prompt", from:prezto
# Set zstyle before zplug load
zstyle ´:prezto:module:prompt´ theme ´sorin´
# Run a command after a plugin is installed/updated
zplug "tj/n", hook-build:"make install"
# Support checking out a specific branch/tag/commit of a plugin
zplug "b4b4r07/enhancd", at:v1
zplug "mollifier/anyframe", commit:4c23cb60
# Install if "if:" tag returns true
zplug "hchbaw/opp.zsh", if:"(( ${ZSH_VERSION%%.*} < 5 ))"
# Can manage gist file just like other plugins
zplug "b4b4r07/79ee61f7c140c63d2786", \
    as:command, \
    from:gist, \
    use:get_last_pane_path.sh
# Support bitbucket
zplug "b4b4r07/hello_bitbucket", \
    as:command, \
    from:bitbucket, \
    hook-build:"chmod 755 *.sh", \
    use:"*.sh"
# Support Gitlab
zplug "willemmali-sh/chegit", \
    as:command, \
    from:gitlab
# Group dependencies, emoji-cli depends on jq in this example
zplug "stedolan/jq", \
    as:command, \
    from:gh-r \
    rename-to:jq, \
    on:"b4b4r07/emoji-cli"
# Defers the loading of a package
# e.g., zsh-syntax-highlighting must be loaded
# after executing compinit command and sourcing other plugins
zplug "zsh-users/zsh-syntax-highlighting", defer:3
# Can manage local plugins
zplug "~/.zsh", from:local
# Load theme file
zplug ´dracula/zsh´, as:theme
# Install plugins if there are plugins that have not been installed
if ! zplug check --verbose; then
    printf "Install? [y/N]: "
    if read -q; then
        echo; zplug install
    fi
fi
# Then, source plugins and add commands to $PATH
zplug load --verbose