Workspace checkpoint
snapshotCheckpoint workspace files git does not track before multi-file refactors, then list or restore checkpoints to roll back changes. Preview restores before writing.
Instructions
Checkpoint and roll back workspace files. action: create (label, paths) | list | restore (id) | delete (id) | mirror (copy to VENIRA_SNAPSHOT_MIRROR_DIR). Use when: before multi-file refactors or overwriting/deleting files git does not hold. Keep paths narrow and check file_count and skipped. Roll back with restore dry_run=true, then restore with verify=true. Avoid when: tiny single-file edits or states git already holds. Output: create: id, file_count, total_bytes, truncated, skipped[]. restore: restored[], deleted_count, skipped[].
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "snapshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Checkpoint id (required for restore/delete; returned by create/list). | |
| label | No | Human label for the checkpoint, e.g. "before refactor auth". | |
| limit | No | list only: max checkpoints to return (default 20). | |
| paths | No | Workspace-relative paths to capture (default ['.'] = whole workspace; scope narrowly). For restore: subset to restore. | |
| action | No | create (default) captures paths; list; restore rolls back an id; delete removes an id; mirror copies the store to VENIRA_SNAPSHOT_MIRROR_DIR. | create |
| reason | No | Optional why (max 400 chars), audit-logged. | |
| verify | No | restore: true (default) verifies each blob before writing. mirror: true re-hashes blobs already at the mirror and re-copies bad ones (default false). | |
| dry_run | No | restore only: true previews path/size changes without writing. | |
| exclude | No | Extra directory/file names to skip. | |
| max_files | No | Max files captured (default 20000, max 20000). | |
| delete_extra | No | restore only: true also deletes files in captured dirs that are not in the checkpoint (max 500). Default false; use only when intended. | |
| max_total_bytes | No | Max total bytes captured (default and max 512 MiB). | |
| respect_default_excludes | No | true (default) skips standard generated/cache directories; false disables those exclusions. |