A (tiny) CLI for Vim plugin manager Vundle
Available commands:
-
rmremove a plugin -
listlist all installed plugins -
findfind an installed plugin -
cleanclean up unused plugin related files -
installinstall a plugin
rm will remove the line Bundle plugin_name or Plugin plugin_name in your .vimrc,
delete the configuration file for this plugin in the specified settings directory,
and the plugin folder. Before anything is deleted, the command will prompt you
for confirmation unless the --force switch is on.
I built this so that it's quicker to uninstall a plugin with my particular vim setup
Installation
Add this line to your application's Gemfile:
gem 'vundle-cli'
And then execute:
$ vundle
Or install it yourself as:
$ gem install vundle-cli
Usage
NAME:
vundle
DESCRIPTION:
A (tiny) CLI for Vim plugin manager Vundle
COMMANDS:
clean Clean up unused plugin related files
find Search for an installed plugin
help Display global or [command] help documentation
install Install a plugin and write to vimrc
list List all installed plugins
rm Remove a plugin
GLOBAL OPTIONS:
-h, --help
Display help documentation
-v, --version
Display version information
-t, --trace
Display backtrace when an error occurs
Commands
NAME:
rm
SYNOPSIS:
vundle rm <plugin> [options]
DESCRIPTION:
Uninstall a plugin.
The command will remove the line ``Bundle plugin_name'' or ``Plugin plugin_name'' in your ``.vimrc'',
delete the configuration file for this plugin in the specified settings directory, and the plugin folder.
Before anything is deleted, the command will prompt you for confirmation unless the ``--force'' switch is on.
EXAMPLES:
# Remove plugin kien/ctrlp.vim
vundle rm kien/ctrlp.vim
# Or, remove any plugin that has ``ctrlp'' in its name (not recommended, it can be too ambiguous)
vundle rm ctrlp
OPTIONS:
--vimdir vimdir
Vim directory. Default to ~/.vim.
--settings settings_dir
Vim settings directory (where you configure your plugins). Default to ~/.vim/settings.
--vimrc vimrc
.vimrc path. Default to ~/.vimrc.
-f, --force
Force delete without confirmation. Disabled by default.
NAME:
list
SYNOPSIS:
vundle list [options]
DESCRIPTION:
List all installed plugins
EXAMPLES:
# List all installed plugins
vundle list --vimrc ~/.vimrc
OPTIONS:
--vimrc vimrc
.vimrc path. Default to ~/.vimrc.
NAME:
find
SYNOPSIS:
vundle find <plugin> [options]
DESCRIPTION:
Search for an installed plugin
EXAMPLES:
# Find a plugin that has substring ``gist''
vundle find gist
OPTIONS:
--vimrc vimrc
.vimrc path. Default to ~/.vimrc.
NAME:
clean
SYNOPSIS:
vundle clean [plugin] [options]
DESCRIPTION:
Clean up unused plugin related files (such as plugin folder and config file).
It will prompt you for confirmation before deleting anything (unless force switch is on).
For option ``--all'', the command gets a list of the plugins in your bundle folder (e.g: ~/.vim/bundle)
and compare them with the plugins in your vimrc in order to determine which plugins need to be cleaned up.
EXAMPLES:
# Clean all unused plugins
vundle clean --all
# Clean plugin vim-signify
vundle clean vim-signify
# Clean any plugins with names that have substring ``dirty''
vundle clean dirty
OPTIONS:
--vimdir vimdir
Vim directory. Default to ~/.vim.
--settings settings_dir
Vim settings directory (where you configure your plugins). Default to ~/.vim/settings.
--vimrc vimrc
.vimrc path. Default to ~/.vimrc.
-a, --all
Delete everything that is not installed in your vimrc. Disabled by default.
-l, --list
List all unused plugins.
-f, --force
Force delete files without prompt. Disabled by default.
NAME:
install
SYNOPSIS:
vundle install <plugin> [options]
DESCRIPTION:
Do NOT add quote to plugin name
OPTIONS:
--vimdir vimdir
Vim directory. Default to ~/.vim.
--vimrc vimrc
.vimrc path. Default to ~/.vimrc.
Contributing
- Fork it ( http://github.com/baopham/vundle-cli/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request