snapper
Manage BTRFS snapshots: list, create, delete, rollback, compare, or clean up snapshots for any configured filesystem.
Instructions
Manage BTRFS snapshots via Snapper. A unified tool for all snapshot operations.
Actions:
configs: List available snapper configurations
list: Show all snapshots for a config
create: Create a new snapshot (optionally with description)
delete: Remove a snapshot by number
rollback: Restore system to a previous snapshot (requires reboot)
cleanup: Prune snapshots using an algorithm (number, timeline, empty-pre-post)
diff: Show file differences between two snapshots
status: List changed files between two snapshots
Current default config: root Using sudo: True
Examples:
List configs: action="configs"
List snapshots: action="list", config="root"
Create snapshot: action="create", config="root", description="Before update"
Delete snapshot: action="delete", config="root", snapshot_id=5
Compare snapshots: action="diff", config="root", snapshot_id=1, snapshot_id_end=5
Cleanup old snapshots: action="cleanup", config="root", cleanup_algorithm="number"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | The snapper action to perform: list (show snapshots), create (new snapshot), delete (remove snapshot), rollback (restore to snapshot), cleanup (prune by algorithm), diff (compare snapshots), status (show changed files), configs (list available configs) | |
| config | No | Snapper configuration name (e.g., 'root', 'home'). Uses default from SNAPPER_MCP_DEFAULT_CONFIG env var if not specified. Use 'configs' action to see available configs. | |
| snapshot_id | No | Snapshot number for delete, rollback, or start of range for diff/status | |
| snapshot_id_end | No | End snapshot number for diff/status range (e.g., diff between snapshot 5 and 10) | |
| description | No | Description for new snapshot (used with 'create' action) | |
| cleanup_algorithm | No | Cleanup algorithm: 'number' (keep N snapshots), 'timeline' (keep by age), 'empty-pre-post' (remove empty pre/post pairs) | |
| sync_after_delete | No | Sync filesystem after delete operation |