NORMAL ~/wkd/p/sessions :set skin=modern utf-8

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.

status
beta — 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.
category
Files & navigation
neovim
0.9+
repo
github.com/WKDSteve/sessions.nvim
commits
235
help
:help sessions

demo

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

install

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

docs/

git log

  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
  9. docs core: the internal mark of save_session stands on it again
  10. test sheets: the sheets of the tree in a session name their acceptance task
  11. test sheets: the tree in a session, against the real own tree of filetree.nvim
  12. fix tree: the exit snapshot `last` keeps the tree the autosave before it closed

keys

j / k
next / previous line
gg / G
first / last line
⏎
open the line under the cursor
/
search plugins and apps (app: x or plugin: x narrows)
:
command line — Tab completes
:help x
vimdoc of a plugin (:e x = plugin page)
:ls · :apps · :play · :log · :stack
plugin list · app list · play area · activity stream · dependency graph
:log apps
the stream of one area (plugins or apps)
:colo x
colorscheme
:set skin=
modern | tui
?
this help
esc
close