Files & navigation · beta · Neovim 0.9+ · 235 commits

sessions.nvim

Branch- and project-aware Neovim sessions. The session name resolves from the project root and the current git branch, so switching branches restores a different workspace and you never have to name anything. Built on Neovim's own :mksession and :source, not around them. Optionally also a mark list — files jumped to by number, with pins and remembered cursor positions — for the handful of files you want one keypress away in every project.

Repository README :help

recorded with VHS from demos/sessions.tape in a clean Neovim — re-recorded weekly
what is shown when
  1. a layout worth keeping - three files, three windows
  2. :Session save - named after the project, no name to invent
  3. :only - and the layout is gone
  4. :Session load - and back

Connections

sessions.nvim: what it uses and what uses it

Tap the picture to open it at full size.

Install

{
  "WKDSteve/sessions.nvim",
  opts = {},
}

Beta stage — active development. This repository is past its first shape and in active use, but the surface is not frozen: breaking changes are still possible. Pin a commit or tag if you depend on it.

Documentation

Recent commits

  1. feat events: SessionsSavePost/LoadPost name the root and the remap
  2. style sheets: stylua on with_ui
  3. test sheets: a sheet with the dialogs of ui.nvim is a skip where ui.nvim is missing
  4. test sheets: the tree sheets wait with the steady step of testing.sheet
  5. docs regenerate the connection pictures (optional loads through probe/safe/package.loaded)
  6. test sheets: a tree snapshot waits until the tree has drawn the same for a while
  7. test sheets: a group of the view git closed by hand is still closed after +LastSession
  8. test sheets: the project of a tree sheet is made in a step of its own

Combos