sesh.nvim

a fork of Folke's persistence.nvim customized to my workflow.

✨ Features

• simple API to save, load, and manage sessions
• options to automatically save or load sessions

⚡️ Requirements

• Neovim >= 0.7.2

📦 Installation

Install the plugin with your preferred package manager:

lazy.nvim

-- Lua
{
  "cdmill/sesh.nvim",
  opts = {
    -- your configuration comes here
    -- or leave it empty to use the default settings
    -- refer to the configuration section below
  }
}

⚙️ Configuration

SESH.nvim comes with the following defaults:

{
    -- directory where session files are saved
    dir = vim.fn.stdpath("state") .. "/sessions/",
    -- if true, auto-saves session before exiting vim. if a number, specifies the minimum
    -- number of file buffers to be open for a session to be saved. note that autosave=true
    -- is equivalent to autosave=1, and autosave=false is equivalent to autosave=0
    autosave = false,
    -- if true, auto-loads session (if one exsits) when starting vim
    autoload = false,
    -- if true, use git branch to save session
    use_branch = true,
}

🚀 Usage

• Open session picker :Sesh.
• Check if SESH.nvim has autosave enabled :Sesh ?.
• Disable autosave if it is enabled :Sesh!.
• Save session for cwd :Sesh save.
• Load session for cwd :Sesh load.
• Delete saved session for cwd :Sesh del.
• Delete all saved sessions :Sesh clean.

Add the <bang> suffix to Sesh on any command to disable autosaving for the cwd. For example, running :Sesh! del will delete the session for the cwd and disable autosaving if enabled.

Inspiration

• Folke persistence.nvim
• Pocco81 neovim-session-manager