@pi-plugins/checkpoint
File checkpoints for pi-agent: restore files on /tree navigation.
Package details
Install @pi-plugins/checkpoint from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@pi-plugins/checkpoint- Package
@pi-plugins/checkpoint- Version
0.1.4- Published
- Sep 14, 2026
- Downloads
- 309/mo · 21/wk
- Author
- kedom1337
- License
- MIT
- Types
- extension
- Size
- 3.6 MB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./dist/index.mjs"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
@pi-plugins/checkpoint
Restore files alongside session history in pi using lightweight checkpoints.
Install
pi install npm:@pi-plugins/checkpoint
To try it for one session without changing your settings:
pi -e npm:@pi-plugins/checkpoint
Usage
Requires Git and a Git repository. Checkpoints are created automatically, with no configuration.
Use /tree to navigate session history. When the destination's files differ from
those on disk, choose whether to navigate with or without restoring files, or cancel.
Restoring files replaces the current worktree contents with the selected checkpoint.
- Navigating to a user message restores the files that prompt originally ran against, including manual edits made between turns.
- Navigating to the end of a turn restores the files as that turn left them.
- Checkpoints remain available after resuming a session with
pi --resume.
Cleanup
/checkpoint-cleanup
After confirmation, this deletes checkpoint history for all sessions in the current worktree and records the current files as a fresh baseline. Conversation history is not deleted, but older conversation points can no longer restore their files.
Notes
- Checkpoints do not change your Git history or staging area.
- New, untracked files are included unless ignored. Files excluded by
.gitignoreare not checkpointed or restored.