zsh-snap-rollback

April 12, 2026 · View on GitHub

License: GPL-3.0 Platform Shell Oh My Zsh

Oh My Zsh plugin for openSUSE Tumbleweed — Safe guided snapper rollback with confirmation and reboot warning.

Part of the zsh-opensuse-tumbleweed ecosystem.


Why zsh-snap-rollback?

Native snapper rollback executes immediately with no safety checks. This plugin adds:

  • Guided flow — calls snap-list -a first so you see all snapshots before choosing
  • Snapshot summary — shows date, type, importance, and description of the target before acting
  • Double confirmation — explicit [y/N] prompt with clear irreversibility warning
  • Dry-run mode — simulate the rollback without executing it
  • Reboot reminder — rollback requires a reboot; the plugin always reminds you

Requirements

  • openSUSE Tumbleweed
  • Oh My Zsh
  • snapper installed and configured
  • zsh-snap-list plugin installed (for the guided display)
  • sudo access

Installation

git clone https://github.com/crisis1er/zsh-snap-rollback \
  ~/.oh-my-zsh/custom/plugins/snap-rollback

Add snap-rollback to your plugins list in ~/.zshrc:

plugins=(... snap-list snap-rollback)

Reload:

source ~/.zshrc

Usage

snap-rollback                    # show all snapshots, then wait for your choice
snap-rollback <id>               # guided rollback to snapshot <id>
snap-rollback <id> --dry-run     # simulate — no action taken

Examples

snap-rollback          # lists all snapshots via snap-list -a
snap-rollback 12       # rollback to snapshot #12 with confirmation
snap-rollback 12 --dry-run

Workflow

snap-rollback
  └─ calls snap-list -a          (shows all configs with colors + summary)
  └─ user picks a number
  └─ snap-rollback <number>
       └─ shows target info (date / type / importance / description)
       └─ [y/N] confirm
       └─ executes snapper rollback
       └─ reminds to reboot

License

GNU General Public License v3.0


Maintainer

SafeITExpertssafeitexperts@safeitexperts.com