Commands
May 16, 2026 · View on GitHub
leanpack.nvim provides a unified command interface for plugin management.
Command Prefix
By default, all commands are prefixed with leanpack. This can be customized in setup:
require('leanpack').setup({
cmd_prefix = 'MyPrefix', -- Commands: MyPrefix update, etc.
})
Available Commands
:Leanpack
Open the plugin manager UI.
:Leanpack
:Leanpack update [plugin]
Update all plugins, or a specific plugin.
:Leanpack update " Update all
:Leanpack update nvim-lspconfig " Update specific
With tab completion for plugin names.
:Leanpack clean
Remove plugins that are no longer in your spec.
:Leanpack clean
:Leanpack build[!] [plugin]
Run the build hook for a plugin.
:Leanpack build telescope " Build specific plugin
:Leanpack build! " Build all plugins with build hooks
:Leanpack load[!] [plugin]
Load an unloaded plugin.
:Leanpack load nvim-tree " Load specific plugin
:Leanpack load! " Load all unloaded plugins
:Leanpack delete[!] [plugin]
Remove a plugin from the filesystem.
:Leanpack delete telescope " Delete specific plugin
:Leanpack delete! " Delete all managed plugins
:Leanpack sync
Synchronize all plugins. This is a shortcut for update followed by clean.
:Leanpack sync
UI Commands
:Leanpack
Opens a floating window with:
- List of all managed plugins with search filtering
- Status (loaded/pending/loading)
- Dependencies
- Build information
Keymaps in UI
| Key | Action |
|---|---|
<Enter> | Load plugin under cursor |
u | Update plugin under cursor |
U | Update all plugins |
<C-u> | Update all loaded plugins |
b | Build plugin under cursor |
d | Delete plugin under cursor |
r | Refresh plugin list |
/ | Search/filter plugins |
<C-c> | Clear search filter |
q | Close UI |
<Esc> | Close UI |
Status Indicators
●- Plugin is loaded○- Plugin is pending (lazy)◐- Plugin is currently loading✗- Plugin is missing from disk (installing in background)
Lua API
leanpack.nvim exposes a minimal Lua API. For plugin management operations, use the :Leanpack commands documented above.
-- Initialize leanpack
require('leanpack').setup({ ... })
See API for the complete Lua API reference.
Health Check
:checkhealth leanpack
Run health checks to verify installation:
:checkhealth leanpack
Checks:
- Neovim version (0.12+ required)
- vim.pack availability
- Git availability
- Unloaded plugins
- Pending build hooks
- Lockfile status
Tab Completion
All leanpack commands support tab completion:
:Leanpack update <Tab> " Complete plugin names
:Leanpack build <Tab> " Complete plugin names
:Leanpack delete <Tab> " Complete plugin names
Output
Commands output to:
- Neovim command line (for simple messages)
- Floating UI (for progress during long operations)
- Log file (for debugging)
Log location: vim.fn.stdpath("log") .. "/leanpack.log"
Next Steps
- API - Complete Lua API reference
- Troubleshooting - Common issues