lazy-tmux

README

   lazy-tmux

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.