Quick start

Start a new session tracked by sess:

sess start backend-debug

This drops you into a fresh tmux session named backend-debug. Work normally — open editors, run servers, split panes, whatever you need.

When you're ready to step away, save it:

sess save

By default this saves under the current tmux session's name. Pass a name explicitly to save it under something else:

sess save backend-debug-friday

Later — tomorrow, after a reboot, whenever — reopen it:

sess open backend-debug

sess recreates the pane layout exactly, cds each pane back to where it was, and relaunches whatever was running.

Switching between sessions

To browse everything you've saved, run sess switch (or just sess with no arguments — they do the same thing):

sess switch

This opens an interactive picker showing every session's state, pane count, and how much space it's using. Selecting one behaves according to its state: it attaches if it's already running, restores it if it's only saved, asks before restoring something stale, and shows you what's wrong if it's broken.

Closing without losing your snapshot

sess close backend-debug

Kills the live tmux session but leaves the saved snapshot untouched — useful when you want to free up the running session without discarding what you saved.

Never forgetting to save

sess start backend-debug --auto-save

Starts a background loop that periodically re-saves the session on its own. See Configuration to make this the default for every new session, and the auto-save command page for the details.