junegunn/vim-plug

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/junegunn/vim-plug.svg?style=card)](https://bestofgithub.dev/repo/junegunn/vim-plug)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/junegunn/vim-plug.svg)](https://bestofgithub.dev/repo/junegunn/vim-plug)

Loading README…

Command	Description
`PlugInstall [name ...] [#threads]`	Install plugins
`PlugUpdate [name ...] [#threads]`	Install or update plugins
`PlugClean[!]`	Remove unlisted plugins (bang version will clean without prompt)
`PlugUpgrade`	Upgrade vim-plug itself
`PlugStatus`	Check the status of plugins
`PlugDiff`	Examine changes from the previous update and the pending changes
`PlugSnapshot[!] [output path]`	Generate script for restoring the current snapshot of the plugins

Option	Description
`branch`/`tag`/`commit`	Branch/tag/commit of the repository to use
`rtp`	Subdirectory that contains Vim plugin
`dir`	Custom directory for the plugin
`as`	Use different name for the plugin
`do`	Post-update hook (string or funcref)
`on`	On-demand loading: Commands or `<Plug>`-mappings
`for`	On-demand loading: File types
`frozen`	Do not remove and do not update unless explicitly specified

Flag	Default	Description
`g:plug_threads`	16	Default number of threads to use
`g:plug_timeout`	60	Time limit of each task in seconds (Ruby & Python)
`g:plug_retries`	2	Number of retries in case of timeout (Ruby & Python)
`g:plug_shallow`	1	Use shallow clone
`g:plug_window`	`-tabnew`	Command to open plug window
`g:plug_pwindow`	`vertical rightbelow new`	Command to open preview window in `PlugDiff`
`g:plug_url_format`	`https://git::@github.com/%s.git`	`printf` format to build repo URL (Only applies to the subsequent `Plug` commands)

junegunn/vim-plug

Pros.

Installation

Vim

Unix

Windows (PowerShell)

Neovim

Unix, Linux

Linux (Flatpak)

Windows (PowerShell)

Usage

Getting Help

Examples

Vim script example

Lua example for Neovim

Commands

`Plug` options

Global options

Keybindings

Post-update hooks

`PlugInstall!` and `PlugUpdate!`

On-demand loading of plugins

Should I set up on-demand loading?

Collaborators

License

Pros.

Installation

Vim

Unix

Windows (PowerShell)

Neovim

Unix, Linux

Linux (Flatpak)

Windows (PowerShell)

Usage

Getting Help

Examples

Vim script example

Lua example for Neovim

Commands

Plug options

Global options

Keybindings

Post-update hooks

PlugInstall! and PlugUpdate!

On-demand loading of plugins

Should I set up on-demand loading?

Collaborators

License

`Plug` options

`PlugInstall!` and `PlugUpdate!`