Skip to content

alchemmist/lazy-tmux

Repository files navigation

Favicon Preview    lazy-tmux

Static Badge License Contributors Go Build

Project architect: @alchemmist

Cli written on Go for saving and restoring tmux sessions lazy. 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 (unlike tmux-resurrect).
  • 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).
  • 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.

Chekout lazy-tmux.xyz for more informaiton about installation and usage!

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

make build

Binary will compiled in bin/lazy-tmux. For more development options run make help.

Warning

tmux version requirement: lazy-tmux requires tmux 3.6 or tmux 3.6a. Older versions may not work correctly.

About

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

Resources

License

Stars

Watchers

Forks

Contributors