aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorIgor Soarez <igor@soarez.org>2026-10-23 13:01:52 +0300
committerIgor Soarez <igor@soarez.org>2026-10-23 13:01:52 +0300
commit0f06b0b15d6b064703fa1166fb8e7ceda209aaa8 (patch)
tree4ecb5cf8daa390ef131962d64925ab0d325b6c39 /README.md
parentde1a3ce438d31df262a026bfb104ca07e656ee30 (diff)
restore, step 1: layout snapshots and dingger restore
the daemon saves the tmux layout when it changes: sessions, windows (index, name, automatic-rename, layout, size, zoom, active), and panes (directory, active, agent). a new history file for layout changes, a rewrite for details, the last 50 kept, nothing saved while tmux is down. when a different server runs (or none), the old server's last snapshot is pinned as the restore candidate before the new server's snapshots start. dingger restore rebuilds missing sessions by tmux id: panes split from the newest so they keep their order, the saved layout applied at the saved size, then the size released so windows follow clients again. a bare session of the same name (a terminal's `new-session -As 0`) is replaced, its clients switched over first; used sessions are kept. --dry-run, --list, --from, --session. e2e step 16 kills a server with a client attached like ghostty's, restarts it, restores, and compares every window and pane; splitting the wrong pane, not replacing bare sessions, not pinning, or keeping the saved size each fail it. e2e keeps its state in its temp dir.
Diffstat (limited to 'README.md')
-rw-r--r--README.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/README.md b/README.md
index fb843ba..7d99306 100644
--- a/README.md
+++ b/README.md
@@ -57,6 +57,14 @@ than a poll is still a completion.
agents are in the menu's order, so ↩ jumps to the top waiting agent. It
takes the keyboard without activating dingger, so focus returns where it
was.
+- **Restore**: dingger saves your tmux layout as it changes (sessions,
+ windows, panes, layouts, directories) under
+ `~/.local/state/dingger/snapshots/`. After a crash, shutdown, or
+ `kill-server`, `dingger restore` brings back what is missing (`--dry-run`
+ to preview, `--list` for saved snapshots, `--session` for some). Sessions
+ that exist are left alone, except a bare one of the same name (what a
+ terminal creates on startup), which is replaced with its clients moved
+ over.
- All shortcuts live in `~/.config/dingger/config.toml` (menu bar,
Settings…), reloaded on save.
- **tmux status line** (`packaging/tmux/dingger.tmux`): the same summary after