Skip to content

Repository files navigation

Favicon Preview    lazy-tmux

Static Badge License Contributors Go Build

Project architect: @alchemmist

CLI written in Go for saving and restoring tmux sessions lazily. Key features:

  • Save sessions: current, specific, or all — including windows, panes, layouts, running commands, and scrollback history.
  • Lazy restore: restore only what you need, avoiding high RAM usage.
  • Autosave daemon: periodically snapshots all sessions in the background (single instance, no conflicts).
  • Interactive TUI browser: tree view (sessions/windows) + table (commands, snapshot time, counts, status) with fuzzy search.
  • Keyboard-driven picker for fast search, navigation, and manage sessions and windows directly inside picker tree.
  • Flexible sorting via --session-sort or --window-sort (by last-used, time, size, name, command, etc.).
  • Optional fzf integration via --fzf-engine (lighter and no dependencies binary, but without full keyboard control and TUI picker); add --windows to pick a specific window instead of a whole session.
  • Bootstrap restore on tmux startup: auto-restore latest or specific session.
  • Full environment snapshots: restore pane layout and commands (e.g. npm, docker-compose, nvim).
  • Optional scrollback capture: preserve and replay previous terminal output.

Save your sessions, kill the entire tmux server, then bring everything back from the TUI picker:

lazy-tmux demo — save, kill-server, and restore via the picker

Check out lazy-tmux.xyz for more information about installation and usage!

Just for building from source you need to have installed go and cloned this project. After that run:

make build

Binary will be compiled in bin/lazy-tmux. For more development options check out Makefile tasks.

Note

tmux versions: lazy-tmux supports every tmux release from 2.9 through 3.7b, verified on each one by the CI version matrix. Newer releases are added as they ship.

For configuration, CLI reference, and usage, see the docs at lazy-tmux.xyz.

About

Lazy tmux it is a fast session manager and saver for tmux. You can save all your session and lazy restore it.

Resources

Stars

201 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages