omp packages

@dieulc/checkpoints0.1.2

Folder checkpoints and /checkpoint for Pi: shadow-git snapshots that work in any folder, git repository or not.

dieulc Published 13 days ago MIT ~641 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

@dieulc/checkpoints

Folder checkpoints for Pi, plus a /checkpoint command.

A checkpoint is a snapshot of a whole folder — an Office document, a pile of images, a code checkout — taken into a shadow git repository under your Pi profile. The project's own .git is never read or written, so this works in a folder that has no repository at all.

Maintained and released from the Pi Desktop repository (packages/checkpoints). The extension source is src/extensions/pi-checkpoints.ts; index.mjs is generated by npm run build:extension and is not hand-edited.

Pi Desktop already bundles this extension. Terminal Pi users can install the published package:

pi install npm:@dieulc/checkpoints

Update with pi update --extensions; remove with pi remove npm:@dieulc/checkpoints.

Requires git on your PATH. Without git the extension stays silent and Pi Desktop's rail shows an explicit "checkpoints need git" state.

What it does

  • One snapshot per user prompt, taken before the prompt is processed (steer and follow-up prompts included).
  • /checkpoint lists this session's checkpoints and can restore files, the conversation, or both. A safety snapshot is taken first, so a restore is itself undoable.
  • A prompt that never gets a turn is kept as an unlinked, files-only checkpoint rather than being dropped.

Where the bytes live

<profile>/checkpoints/<folder-name>-<hash>/ — one bare repository per folder, shared with Pi Desktop. Retention defaults: 100 checkpoints, 30 days, 2 GB per folder. /checkpoint prunes nothing itself; Pi Desktop's Checkpoints section and Settings do.

Development

npm run build:extension
pi install path:<absolute path to this repository>/packages/checkpoints

The package is built from src/extensions/pi-checkpoints.ts and released with npm run release:extension from the Pi Desktop repository.

@dieulc/workflow keeps its separate /rewind command for git-backed message and file restore. This package's /checkpoint is the folder-wide implementation used by Pi Desktop, including folders that are not git repositories.