Features:
- continuous saving of tmux environment
- automatic tmux start when computer/server is turned on
- automatic restore when tmux is started
Together, these features enable uninterrupted tmux usage. No matter the computer or server restarts, if the machine is on, tmux will be there how you left it off the last time it was used.
Tested and working on Linux, OSX and Cygwin.
Tmux environment will be saved at an interval of 15 minutes. All the saving happens in the background without impact to your workflow.
This action starts automatically when the plugin is installed. Note it requires
the status line to be on
to run (since it uses a hook in status-right to run).
Tmux is automatically started after the computer/server is turned on.
See the instructions on how to enable this for your system.
Last saved environment is automatically restored when tmux is started.
Put set -g @continuum-restore 'on'
in .tmux.conf
to enable this.
Note: automatic restore happens exclusively on tmux server start. No other
action (e.g. sourcing .tmux.conf
) triggers this.
tmux 1.9
or higher, bash
,
tmux-resurrect plugin.
Installation with Tmux Plugin Manager (recommended)
Please make sure you have tmux-resurrect installed.
Add plugin to the list of TPM plugins in .tmux.conf
:
set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @plugin 'tmux-plugins/tmux-continuum'
Hit prefix I
to fetch the plugin and source it. The plugin will
automatically start "working" in the background, no action required.
Please make sure you have tmux-resurrect installed.
Clone the repo:
$ git clone https://github.com/tmux-plugins/tmux-continuum ~/clone/path
Add this line to the bottom of .tmux.conf
:
run-shell ~/clone/path/continuum.tmux
Reload TMUX environment with: $ tmux source-file ~/.tmux.conf
The plugin will automatically start "working" in the background, no action required.
- frequently asked questions
- behavior when running multiple tmux servers -
this doc is safe to skip, but you might want to read it if you're using tmux
with
-L
or-S
flags - automatically start tmux after the computer is turned on
- continuum status in tmux status line
- tmux-copycat - a plugin for regex searches in tmux and fast match selection
- tmux-yank - enables copying highlighted text to system clipboard
- tmux-open - a plugin for quickly opening highlighted file or a url
- In order to be executed periodically, the plugin updates the
status-right
tmux variable. In case some plugin (usually themes) overwrites thestatus-right
variable, the autosave feature stops working. To fix this issue, place the plugin last in the TPM plugins list.
Both contributing and bug reports are welcome. Please check out contributing guidelines.