../BIN/VIM-ADDON-MANAGER(1)

🌸 vim-addon-manager 🌸

ok so bestie, gather round, because this is vim-addon-manager, the command line manager of Vim add-ons, and it lives in the General Commands Manual section of ../BIN/VIM-ADDON-MANAGER(1) — yes that's the manual name, we're not ignoring it, we're just being cute about it 💅

---

✨ NAME ✨

vim-addon-manager — command line manager of Vim add-ons 🎀

---

🦋 SYNOPSIS 🦋

vim-addons [OPTION ...] [COMMAND [ADDON ...]]

---

💖 DESCRIPTION 💖

Manage Vim addons installed system-wide, enabling on a per-user basis their installation, removal, ... like that's the whole vibe 🫶

vim-addons is capable of managing all Vim addons registered in the system-wide registry of Vim addons (see vim-registry(5)). No cap.

So every system-wide addon can be, with respect to a user Vim configuration, in one of these states. Vibe check, one by one:

installed

All of the files composing the addon are installed (i.e. symlinked) to their respective places under the target directory. The addon is fully functional for the current user ✨

removed

The files composing the addon are not installed under the target directory. The addon might still be working for the current user if it is installed system-wide by the local administrator 👀

disabled

The files composing the addon are not installed under the target directory, but the addon is installed system-wide. However, the addon has been disabled for the current user explicitly via some configuration line in plugin/vim-addons.vim under the target directory. The addon is not working for the current user 🙈

broken

Only some of the files composing the addon are installed under the target directory. The addon is probably not working for the current user 💀

unavailable

Some (or all) of the files composing the addon are missing from the source directory 😭

---

👑 COMMANDS 👑

A number of commands can be given to vim-addons to inspect or alter the status of the addons: list, status, install, remove, disable, amend, files, show.

ngl bestie, amend gets name-dropped in that list but the page never describes it, so we're just holding the receipt here 🧾

A description of the semantics of each command is reported below. Slay, let's go:

list

List, one per line, the names of the addons available in the system (i.e. of all the addons mentioned in the registry, not necessarily of all enabled addons) 📝

status

Show, one per line, the status of the addons available in the system. If one or more addon arguments are specified, only show the status of those addons. This is the default command if nothing is specified. main character energy, honestly ⭐

install

Install one or more addons under the target directory. Requires at least one addon argument 🔥

remove

Remove one or more addons from the target directory. Requires at least one addon argument 🧹

disable

Disable one or more addons to be used by the current user. Usually used for addons which are system-wide enabled by the local administrator but that the current user does not want to be used. Using this command will automatically change the content of plugin/vim-addons.vim under the target directory, probably adding ":let" commands which will inhibit the given addon from being used. Requires at least one addon argument 🚫

enable

Undo the effects of a previous disable command. Requires at least one addon argument 🌈

files

List, one per line, the files composing the specified addons. Files are listed relative to components of the Vim runtimepath (see 'runtimepath' in the Vim help). Requires at least one addon argument 🍓

show

Displays detailed information about the specified addons 🔍

---

💅 OPTIONS 💅

All commands accept the following options. Every single one, we're not skipping a crumb:

• -h, --help — show this usage message and exit 🎀
• -q, --query — be quiet and make the output more parseable (for "status")
• -r, --registry-dir — set the registry directory (default: /usr/share/vim/registry)
• -s, --source-dir — set the addons source directory (default: /usr/share/vim/addons)
• -t, --target-dir — set the addons target directory (default: $HOME/.vim)
• -v, --verbose — increase verbosity level 📢
• -z, --silent — silent mode: suppress most of the output 🤫
• -y, --system-dir — set the system-wide target directory (default: /var/lib/vim/addons)
• -w, --system-wide — set the addons target directory to the system-wide target directory, possibly overriding the -t option 👑

---

🫶 AUTHOR 🫶

Stefano Zacchiroli <zack@debian.org> and James Vega <jamessan@debian.org> — icons, both of them 💜

---

🌸 SEE ALSO 🌸

vim(1), vim-registry(5)

---

💖 COPYRIGHT 💖

Copyright (C) 2007 Stefano Zacchiroli Copyright (C) 2009 James Vega

This program is free software, you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

---

ok that's the whole thing, bestie, you ate it 💅 This lil page is dated January 2026 and comes from ../BIN/VIM-ADDON-MANAGER(1). go forth and manage your addons, periodt ✨🦋🎀