feat(konsole): ✨ add session save/restore with staggered agent resume

ARCH_INDEX.md

@@ -90,6 +90,9 @@ Editor configuration (Neovim, Helix, etc.).
 
 Terminal emulator configuration.
 
+Contents:
+- `konsole/session/` — save/restore Konsole windows, tabs, and the agent conversations in them across restarts (openSUSE Tumbleweed + KDE Plasma 6 only; installed separately)
+
 ---
 
 ## fonts/

konsole/session/README.md

@@ -0,0 +1,67 @@
+# konsole-session
+
+Save every Konsole window and tab before a restart and bring them back at the next login, including the
+Claude Code and Codex conversations running in them.
+
+**openSUSE-specific.** Requires openSUSE Tumbleweed with KDE Plasma 6 (X11 or Wayland) and Plasma's
+systemd-managed session.
+
+## Install
+
+```sh
+bash konsole/session/install.sh
+```
+
+Copies `konsole-session` to `~/.local/bin/` and `konsole-session-restore.service` to
+`~/.config/systemd/user/`, then enables the unit. Dependencies: `konsole`, `qt6-tools-qdbus`, `kf6-kconfig`,
+`python3`.
+
+## Use
+
+```sh
+konsole-session save     # right before restarting
+```
+
+The next login restores everything once, then archives the snapshot under
+`~/.local/state/konsole-session/restored-*`. A snapshot can also be restored by hand:
+
+```sh
+konsole-session restore [SNAPSHOT] [--stagger SECONDS]
+```
+
+## What comes back
+
+| Saved | Restored as |
+| --- | --- |
+| Window virtual desktop, screen, geometry, maximized | Placed through a KWin script |
+| Tab order, title, color, profile, working directory, active tab | Same |
+| Claude Code tab | `claude … --resume <id>` with the original flags, in the directory the session was in |
+| Claude Code wrapper tab (`claude-<name>`, state in `~/.claude-<name>`) | `<wrapper> … --resume <id>` of the transcript it wrote last |
+| Codex tab (direct or via a wrapper script) | `codex resume <id>` of the rollout file it was writing |
+| Any other running program | Same command line |
+| `sudo`/`su`/`doas`/`pkexec`/`run0` | Plain shell — privileged commands are never replayed |
+
+Not restored: scrollback, split views (restored as tabs), replies that were mid-flight (the conversation
+resumes at its last saved message), and background tasks an agent had running.
+
+## Staggered start
+
+Tabs open immediately, but the commands inside them start one every `--stagger` seconds (default 20), most
+recently active conversation first, so a restore doesn't start every agent at once. Each waiting tab shows a
+countdown; Ctrl-C skips that tab's command and prints how to start it by hand.
+
+A conversation that is already running somewhere else is not resumed a second time; its tab opens as a
+plain shell.
+
+## How it works
+
+- Konsole's D-Bus `runCommand`/`sendText` are disabled by default, so tabs with a command start from a small
+  launcher script (countdown, command, then a normal interactive shell) passed via `--tabs-from-file`.
+- Each window runs in its own transient `app-konsole-session-restore-*` unit so it outlives the oneshot
+  restore service.
+- Plasma's own session restore reopens Konsole without the programs that were running; those windows are
+  closed during a login restore and replaced.
+- The unit is wanted by `xdg-desktop-autostart.target`. Hooking it to `plasma-workspace.target` creates an
+  ordering cycle with `plasma-restoresession.service`, and systemd silently drops the job.
+- Screen names differ between X11 and Wayland (e.g. `DP-0` vs `DP-1`), so a snapshot taken under one and
+  restored under the other can put windows on the wrong screen.

konsole/session/install.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# konsole-session installer (openSUSE Tumbleweed, KDE Plasma 6)
+# Copies the script and its login unit into place and enables the unit.
+# Idempotent — safe to run multiple times.
+
+TOOL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BIN_DIR="$HOME/.local/bin"
+UNIT_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/systemd/user"
+UNIT="konsole-session-restore.service"
+
+if [[ "$(uname -s)" != "Linux" ]] || ! command -v zypper >/dev/null 2>&1; then
+  echo "✖ konsole-session is openSUSE-specific (zypper not found)"
+  exit 1
+fi
+
+missing=()
+for dep in konsole qdbus6 kreadconfig6 systemctl systemd-run journalctl /usr/bin/python3; do
+  command -v "$dep" >/dev/null 2>&1 || missing+=("$dep")
+done
+if (( ${#missing[@]} )); then
+  echo "✖ missing: ${missing[*]}"
+  echo "  sudo zypper install konsole qt6-tools-qdbus kf6-kconfig python3"
+  exit 1
+fi
+
+echo "▶ Installing konsole-session"
+mkdir -p "$BIN_DIR" "$UNIT_DIR"
+install -m 0755 "$TOOL_DIR/konsole-session" "$BIN_DIR/konsole-session"
+install -m 0644 "$TOOL_DIR/$UNIT" "$UNIT_DIR/$UNIT"
+
+# Re-enable so a changed [Install] section replaces any previous wants link.
+systemctl --user disable "$UNIT" >/dev/null 2>&1 || true
+systemctl --user daemon-reload
+systemctl --user enable "$UNIT"
+
+echo "  installed  $BIN_DIR/konsole-session"
+echo "  enabled    $UNIT"
+echo
+echo "Run 'konsole-session save' right before restarting; windows come back at the next login."