konsole_backup/AGENTS.md

AGENTS.md

Overview

Lightweight Bash utility scripts for KDE Konsole configuration backup, cross-device synchronization, and restoration.

Key Features & Commands

• Backup: ./backup.sh

  • Automatically strips device-specific screen geometry / monitor layouts ([MainWindow] section in konsolerc) to ensure clean cross-device sync.
  • Staged in backups/ with default naming format: konsole_backup_<hostname>_YYYYMMDD_HHMMSS.zip.
  • Prompts user to confirm or edit the backup archive filename before saving.
  • Enforces a retention policy of max 10 backups (older ones deleted and removed via git rm if inside a git repository).
  • Prompts to commit and push the new backup to git remote.

• Restore: ./restore.sh [optional_zip_path]

  • Supports positional arguments, stdin piping (echo "file.zip" | ./restore.sh), and an interactive selection menu if no input is provided.
  • Sanitizes konsolerc to avoid overwriting the target machine's window/screen geometry.
  • Supports file-by-file diff preview ([d]) using git diff --no-index or diff.
  • Reads interactive prompts safely from /dev/tty when stdin is redirected.

Target Paths (Relative to $HOME)

• .config/konsolerc (sanitized of [MainWindow] geometry)
• .local/share/konsole (profiles, color schemes, bookmarks, keytabs)
• .local/share/kxmlgui5/konsole (UI toolbars / actions)
• .config/konsole.notifyrc
• .config/konsolesshconfig

Implementation Details & Conventions

• Shell: Pure Bash 4+ with set -euo pipefail.
• Safety: Uses mktemp -d for temporary staging directories with trap ... EXIT cleanup.
• Verification: Run bash -n backup.sh restore.sh to check syntax.