Vim stores the current state of views, window positions, and settings in a session. You can save the session to a file and load it at a later time to return vim to the same saved state.
Create and Use Sessions
Use the command
:mksession [file] to save the current state to a file, by default vim will use
Session.vim filename if none specified.
To load a saved session use
vim -S [file]
Working with sessions can be a little tedious. You need to remember to update saving your state anytime you open a new file or change the window layouts. I use the obsession.vim plugin to help manage sessions.
The plugin manages keeping the state updated and will automatically save on quit. You simply run
:Obsess [file] to start, if you don’t specify a filename it will use
Session.vim by default.
The state will be managed for you until you exit vim. You load the session the same as above, using
vim -S Session.vim
I use the Startify plugin to replace the empty start screen with a fancy one that includes a listing of recent files. With startify, you also get a quoting cow. Startify detects if a
Session.vim file exists, and allows a shortcut key to open it. This is nice when you forget to load a session on the command-line.
Startify does have session features itself, however, I don’t use them. See the Startify documentation for how the plugin works with sessions and which way you prefer.
💡 I add
Session.vim to my global
.gitignore file so it doesn’t show in git commands and I don’t have to add it to each project.