2.0.0 removes every option and command that was deprecated during the 1.x series. The renamed options (confirm, disable_vim_loader, plugins_dir) emitted runtime warnings throughout 1.x; the legacy :Z* commands are removed in favor of the :ZPack <subcommand> dispatcher. Removed options are now ignored silently, so update your setup() call before upgrading:

The per-action :Z* commands are now subcommands of a single :ZPack command:

The command name is configurable via cmd_name (default ZPack). If you relied on the old cmd_prefix = 'Z', set cmd_name = 'Z' to type :Z update, :Z clean, etc. The ! bang is still supported where it was before (e.g. :ZPack! build, :ZPack! delete).

Most of your lazy.nvim plugin specs will work as-is with zpack. However, zpack follows vim.pack conventions over lazy.nvim conventions, and is missing a few advanced features:

• version pinning: lazy.nvim's version field maps to zpack's sem_version. See Spec Reference and version pinning examples
• dev mode: Set dev = true on a spec and configure setup({ dev = { path = '~/projects' } }) — the source is rewritten to <path>/<plugin-name>. Live file-watch / auto-reload is out of scope; use :ZPack reload {plugin} to manually re-source. See Spec Reference for dev/deactivate
• profiling: Use nvim --startuptime startuptime.log. Also refer to example Neovim Profiler script
• default lazy plugins: lazy.nvim's community specs silently default top-level specs for utility libraries like plenary.nvim to lazy = true, even without lazy triggers or a lazy parent. zpack respects your specs as-written, so set lazy = true explicitly on such specs if you want the same default — or set defaults.lazy = true in setup() to apply it to every spec
• enabled vs cond: lazy.nvim collapses both to a single "disabled" state. zpack splits them: enabled = false skips install entirely (the plugin is never cloned), while cond = false installs the plugin but skips its load (so it still shows up under vim.pack's data dir). Use enabled when you want lazy.nvim's "don't install at all" behavior

Known gotchas when using zpack:

• install/update feedback: vim.pack surfaces install/update progress via :messages (e.g. vim.pack: Downloading updates (0/83)). These messages are hidden if you have vim.opt.cmdheight = 0 — raise it, check :messages, or route them through a notifier like snacks.notifier, nvim-notify, or noice.nvim. Also see noice.nvim with vim.pack for compatibility notes

The default Snacks.nvim dashboard configuration includes a startup time section that has a hard dependency on lazy.nvim. This will cause errors with any other plugin manager, not just zpack.

To work around this, remove the startup section from your dashboard configuration:

require('snacks').setup({
  dashboard = {
    sections = {
      { section = "header" },
      { section = "keys", gap = 1, padding = 1 },
      -- { section = "startup" }, -- Remove this line (depends on lazy.nvim)
    },
  }
})

See snacks.nvim#1778 for more details.

noice.nvim filters out vim.pack messages by default, which means you won't see install/update notifications from your plugin manager.

To fix this, add a route that explicitly shows vim.pack messages:

require('noice').setup({
  routes = {
    {
      filter = {
        event = "msg_show",
        find = "vim.pack",
      },
    },
  },
})

On Neovim 0.13+, the :ZPack update, restore, and delete subcommands have native vim.pack command equivalents (:packupdate, :packupdate ++lockfile, :packdel). Use whichever you prefer — zpack keeps its session state in sync either way. See :h zpack-native-commands for the full mapping.