tmux-plugins/tmux-resurrect
Tmux Resurrect
tmux-resurrect is a terminal workspace persister and session manager implemented as a plugin for the tmux terminal multiplexer. It captures and stores the state of active sessions, window layouts, and working directories to maintain a workspace across system restarts.
The utility distinguishes itself by recovering more than just layouts, offering the ability to relaunch specific programs via configurable lists and persisting the state of open files and cursor positions in text editors. It also captures visible pane text and provides timestamped snapshot versioning to revert the workspace to a specific previous point.
The tool provides broader capabilities for environment management, including customizable keyboard shortcuts for saving and restoring, configurable state storage locations, and lifecycle hooks to execute user-defined commands during the persistence process.
Features
- tmux Session Managers - Automates the saving and restoring of tmux layouts, windows, and working directories across system restarts.
- Interactive Session Recovery - Resumes coding workflows by reopening specific editor sessions and running programs within tmux.
- Terminal Multiplexer Plugins - Extends the tmux terminal multiplexer with custom state management and session recovery capabilities.
- Terminal Session Persisters - Captures terminal pane configurations and active programs to recreate a specific development environment.
- Terminal Workspace Layouts - Organizes and recovers complex sets of terminal sessions and pane arrangements after system reboots.
- Workspace Session Managers - Captures all active sessions, pane layouts, and working directories into a persistent store for later recovery.
- Terminal State Preservation - Captures active shell states and directory paths to avoid manual reconfiguration of the terminal environment.
- Environment Reconstruction Scripts - Reconstructs the terminal environment by executing a sequence of tmux commands based on parsed metadata from save files.
- State Persistence - Serializes tmux session layouts and working directories into files to maintain state across system reboots.
- Persistence Lifecycle Hooks - Triggers custom callbacks during the lifecycle of the workspace persistence process to handle external setup.
- Editor State Persistence - Persists the state of open files and cursor positions in text editors to be reopened after a session restore.
- Persistence Lifecycle Hooks - Allows execution of user-defined shell commands immediately before or after workspace save and restore operations.
- Configuration Version Snapshots - Stores timestamped state files to allow the workspace to be reverted to a specific previous point.
- Workspace State Versioning - Reverts the session layout and working directories to a specific point in time by selecting a timestamped save file.
- Process Restoration Patterns - Matches running process names against a configurable whitelist to automatically relaunch programs after session restoration.
- Pane Content Persistence - Saves and restores the text currently visible in panes so that the previous screen state is recovered after a restart.
- Process Auto-Relaunch - Relaunches specific processes and commands in panes after a session restoration using a configurable list.
- General Plugins - Persists environment across system restarts.
