@linzumi/cli 1.0.53 → 1.0.55

package/README.md

@@ -58,7 +58,7 @@ Install the CLI or run it with `npx`:
 ```bash
 npm install -g @linzumi/cli@latest
 npx -y @linzumi/cli@latest signup
-npx -y @linzumi/cli@1.0.53 --version
+npx -y @linzumi/cli@1.0.55 --version
 linzumi --version
 ```
 
@@ -168,6 +168,28 @@ The trust list lives at `~/.linzumi/config.json`. The bootstrap agent
 adds `/tmp/hello_linzumi` for you on first run. For `linzumi connect`, the
 selected `--cwd` is also trusted for that runner process.
 
+## Git safety snapshots
+
+Before an agent turn runs in a git workspace with uncommitted changes, the
+runner saves a safety snapshot: dirty tracked state as a dangling `git stash
+create` commit (pinned under `refs/linzumi/safety/`, never touching your
+working tree) plus copies of untracked, non-ignored files under
+`~/.linzumi/safety-snapshots/` (up to 200MB per snapshot; oversized files are
+skipped loudly). A clean tree costs one `git status` and stores nothing.
+Snapshots are pruned after 72 hours or beyond the newest 50.
+
+If a turn discards work you wanted, recover it:
+
+```bash
+linzumi safety-snapshots list
+linzumi safety-snapshots restore <snapshot-id> --to ./recovered
+```
+
+Restore materializes the snapshot into a new directory and never overwrites
+current files; the listed stash commit also works directly with
+`git stash apply <sha>`. Default ON; set `LINZUMI_GIT_SAFETY_SNAPSHOTS=0` to
+disable.
+
 ## When something looks wrong
 
 Run `linzumi --help` or reconnect with `linzumi start ~/code/my-app`.