lazy-tmux

Features

• Save current session, one session, or all sessions: save.
• Lazy restore only what you pick: restore / picker.
• Built-in TUI tree picker: session -> windows + fuzzy search.
• Optional picker backend with --fzf-engine.
• Daemon autosave mode with single-instance lock per tmux socket.
• Bootstrap restore at tmux startup: latest or named session.
• Snapshot includes window/pane structure and command replay on restore.

Install

make install
# or
go install ./cmd/lazy-tmux

# local build
make build
# binary: bin/lazy-tmux

Quick tmux setup

run-shell -b 'lazy-tmux daemon --interval 5m >/tmp/lazy-tmux.log 2>&1'
run-shell -b 'lazy-tmux bootstrap --session last >/tmp/lazy-tmux-bootstrap.log 2>&1'
bind-key s run-shell 'lazy-tmux save --all'
bind-key f display-popup -E -w 100% -h 100% 'lazy-tmux picker'

CLI

lazy-tmux save [--all] [--session NAME] [--data-dir DIR]
lazy-tmux restore --session NAME [--switch=true]
lazy-tmux picker [--fzf-engine]
lazy-tmux bootstrap [--session last|NAME]
lazy-tmux daemon [--interval 5m]
lazy-tmux list