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
demos/sessions.tape in a clean Neovim — re-recorded weekly
what is shown when
- a layout worth keeping - three files, three windows
- :Session save - named after the project, no name to invent
- :only - and the layout is gone
- :Session load - and back
install
{
"WKDSteve/sessions.nvim",
opts = {},
} docs/
- BINDINGS.md
- CONTRIBUTING.md
- FEATURES.md
- README.md
- WORKFLOW.md
- api.md
- commands.md
- configuration.md
- git-integration.md
- installation.md
- marks.md
- metadata.md
- picker.md
- portability.md
- quickstart.md
- session-scoping.md
- statusline.md
- troubleshooting.md
- what-you-get.md
git log
- feat events: SessionsSavePost/LoadPost name the root and the remap
- style sheets: stylua on with_ui
- test sheets: a sheet with the dialogs of ui.nvim is a skip where ui.nvim is missing
- test sheets: the tree sheets wait with the steady step of testing.sheet
- docs regenerate the connection pictures (optional loads through probe/safe/package.loaded)
- test sheets: a tree snapshot waits until the tree has drawn the same for a while
- test sheets: a group of the view git closed by hand is still closed after +LastSession
- test sheets: the project of a tree sheet is made in a step of its own
- docs core: the internal mark of save_session stands on it again
- test sheets: the sheets of the tree in a session name their acceptance task
- test sheets: the tree in a session, against the real own tree of filetree.nvim
- fix tree: the exit snapshot `last` keeps the tree the autosave before it closed