GitHub - folke/persistence.nvim: 💾 Simple session management for Neovim (original) (raw)

Persistence is a simple lua plugin for automated session management.

✨ Features

⚡️ Requirements

📦 Installation

Install the plugin with your preferred package manager:

lazy.nvim

-- Lua { "folke/persistence.nvim", event = "BufReadPre", -- this will only start session saving when an actual file was opened opts = { -- add any custom options here } }

⚙️ Configuration

Persistence comes with the following defaults:

{ dir = vim.fn.stdpath("state") .. "/sessions/", -- directory where session files are saved -- minimum number of file buffers that need to be open to save -- Set to 0 to always save need = 1, branch = true, -- use git branch to save session }

🚀 Usage

Persistence works well with plugins like startify or dashboard. It will never restore a session automatically, but you can of course write an autocmd that does exactly that if you want.

-- load the session for the current directory vim.keymap.set("n", "qs", function() require("persistence").load() end)

-- select a session to load vim.keymap.set("n", "qS", function() require("persistence").select() end)

-- load the last session vim.keymap.set("n", "ql", function() require("persistence").load({ last = true }) end)

-- stop Persistence => session won't be saved on exit vim.keymap.set("n", "qd", function() require("persistence").stop() end)

📅 Events