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.
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
Connections
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
- docs/BINDINGS.md
- docs/CONTRIBUTING.md
- docs/FEATURES.md
- docs/README.md
- docs/WORKFLOW.md
- docs/api.md
- docs/commands.md
- docs/configuration.md
- docs/git-integration.md
- docs/installation.md
- docs/marks.md
- docs/metadata.md
- docs/picker.md
- docs/portability.md
- docs/quickstart.md
- docs/session-scoping.md
- docs/statusline.md
- docs/troubleshooting.md
- docs/what-you-get.md
Recent commits
- 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
Combos
- Statusline segments
Each contributes one optional segment to ui.nvim's statusline -- none is a dependency, the segment is simply absent without it.
ui.nvim , filetree.nvim , github_stats.nvim , runtime-analysis.nvim , recommender.nvim , sandbox.nvim