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

KeyAction
<Enter>Load plugin under cursor
uUpdate plugin under cursor
UUpdate all plugins
<C-u>Update all loaded plugins
bBuild plugin under cursor
dDelete plugin under cursor
rRefresh plugin list
/Search/filter plugins
<C-c>Clear search filter
qClose 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