tmux-restore

Name: tmux-restore
Author: andrewboldi

Pending

Reboot-proof tmux: every session, layout and scrollback comes back, and Claude Code, Codex, Gemini CLI, opencode and pi reopen the conversations they were in.

60stars

3forks

Shell

Installation

# Add to your Claude Code skills
git clone https://github.com/andrewboldi/tmux-restore

Getting Started

Guides for using ai agents skills like tmux-restore.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
How to Test an AI Skill: A Practical Guide to Evals
Evaluate skills with realistic fixtures, a baseline, and repeatable checks.
Getting Started with AI Skills

Compare with similar skills

See how tmux-restore compares with popular alternatives.

tmux-restore vs rea

See comparison

tmux-restore vs hermes agent

See comparison

tmux-restore vs ecc

See comparison

README.md

Frequently Asked Questions

What is tmux-restore?

tmux-restore is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by andrewboldi. Reboot-proof tmux: every session, layout and scrollback comes back, and Claude Code, Codex, Gemini CLI, opencode and pi reopen the conversations they were in. It has 60 GitHub stars.

Is tmux-restore safe to use?

tmux-restore's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install tmux-restore?

Clone the repository with "git clone https://github.com/andrewboldi/tmux-restore" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is tmux-restore written in?

tmux-restore is primarily written in Shell. It is open-source under andrewboldi on GitHub, so you can review or fork the full source.

Are there alternatives to tmux-restore?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh tmux-restore against similar tools.

AI Courses · Agentic AI, LLM Engineering & MCP

Beginner to professional · First lesson free · Lifetime access

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

rea

by morluto

Reverse engineer anything with agents, from app behavior down to native binaries.

439,084

threads-auto-poster travel-roamradar

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

Ever rebooted and lost a dozen tmux windows, along with the agent conversations running in them? tmux-restore saves everything every minute and right before shutdown, and puts it back when tmux starts. Panes running Claude Code, Codex, Gemini CLI, opencode or pi reopen the exact conversation they were in.

What it does

Everything comes back. Sessions, windows, splits, working directories and scrollback.
Agents resume mid-conversation. Each one reopens its own conversation, with the same flags.
Saved at shutdown, not just on a timer. Every minute, plus once more as the machine goes down.
Nothing risky re-runs. Editors and monitors restart. Anything else (a deploy, a dev server) comes back typed on the prompt, waiting for Enter.

Install

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

It installs whatever is missing (tmux, TPM, the plugins) and turns everything on. Run it again to update.

How it works

Save. Every minute, tmux-resurrect records every session, window, pane and its scrollback.
Rewrite. For each pane running an agent, a small adapter finds the conversation's id in the agent's own session files and saves the command that resumes it.
Shutdown. A background service (systemd on Linux, launchd on macOS) saves once more the moment the machine starts going down.
Restore. When tmux starts, tmux-continuum puts it all back, and the agents reopen their conversations.

More in how it works. Using another agent? An adapter is one short file; see CONTRIBUTING.md.

License

MIT. Built on tmux-resurrect and tmux-continuum by Bruno Sutic and contributors.