tmux restore — Seamlessly restore your tmux sessions and…

Pitch

Description

Comments

About this project

tmux-restore offers a reliable solution for preserving every aspect of your tmux session, from windows and layouts to scrollback history. It re-establishes ongoing conversations with agents like Claude Code and Codex, ensuring that all work is preserved. Experience uninterrupted coding with a straightforward installation and intelligent session management.

tmux-restore

Reboot-proof tmux: ensuring a seamless continuity of your coding sessions. This innovative tool captures every aspect of your tmux environment, allowing all sessions, layouts, and scrollback to be restored even after a reboot.

When using coding agents like Claude Code, Codex, Gemini CLI, opencode, or pi, your conversations can be resumed right where they left off. tmux-restore automatically saves your sessions every minute and additionally right before system shutdown, guaranteeing that no vital information is lost.

Key Features

Complete Restoration: Retrieve all sessions, windows, splits, working directories, and scrollback seamlessly after a reboot.
Agent Conversation Resume: Each coding agent reopens its respective conversation with the same parameters intact.
Smart Saving: The tool not only saves sessions periodically but also captures the state during system shutdown.
Safe Reboots: Editors and monitors are restored while potentially risky commands are saved as text, waiting for prompt confirmation.

Installation

Installation is straightforward. Simply run the provided script to install the necessary components, including tmux, TPM, and required plugins, to get started effortlessly.

curl -fsSL https://raw.githubusercontent.com/andrewboldi/tmux-restore/main/install.sh | bash

Functionality Overview

Save: The tool interfaces with tmux-resurrect to log all active sessions, windows, and panes along with scrollback data every minute.
Rewrite: A dedicated adapter captures the conversation ID from each agent's session files and saves the relevant command for restoration.
Shutdown: A background service ensures a final save when the machine begins shutting down, securing all necessary session data.
Restore: Upon restarting tmux, tmux-continuum facilitates full restoration of the previous environment along with agent conversations.

For those looking to customize or extend the functionality for additional agents, creating an adapter is a simple task detailed in the contributing documentation.

Conclusion

In summary, tmux-restore offers a robust solution to maintain continuity in coding environments, facilitating a smooth and efficient workflow that minimizes disruptions caused by system reboots.