@dieulc/checkpoints

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

Packages

Package details

extension

Install @dieulc/checkpoints from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@dieulc/checkpoints

Package: @dieulc/checkpoints
Version: 0.1.2
Published: Oct 31, 2026
Downloads: 641/mo · 468/wk
Author: dieulc
License: MIT
Types: extension
Size: 41.9 KB
Dependencies: 0 dependencies · 0 peers

Pi manifest JSON

{
  "extensions": [
    "./index.mjs"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

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.