pi-session-track
v0.1.0
Published
Pi Coding Agent extension: registers the session_track tool that copies Pi session JSONL files for the current workspace into the workspace's .pi/agent/sessions/ as a local, untracked-by-default backup (commit-time session tracking per the git-commit skil
Downloads
152
Readme
pi-session-track
Pi Coding Agent extension that registers the session_track tool — commit-time session backup for Pi Coding Agent workspaces.
What it does
A call to session_track copies Pi's session history for the current workspace:
- Derives the session directory name from the working directory (
/Users/user/repos/ctx2loc→--Users-user-repos-ctx2loc--) - Finds all
.jsonlfiles in~/.pi/agent/sessions/<encoded-cwd>/ - Copies them into
./.pi/agent/sessions/<encoded-cwd>/(destination is always under./.pi/)
The copy always runs — tracked or not. By default .pi/ is gitignored, so the backup stays local and untracked; tracking is operator opt-in only (remove the path from .gitignore and instruct the commit).
Install
Via npm (published):
pi install npm:pi-session-trackVia git:
pi install git:github.com/F1LT3R/pi-session-trackManual (managing ~/.pi/agent/extensions/ yourself):
git clone https://github.com/F1LT3R/pi-session-track.git
ln -s "$PWD/pi-session-track/index.ts" ~/.pi/agent/extensions/session-track.tsThen /reload in Pi (or start a new session). Verify with pi list.
Remove: pi remove npm:pi-session-track (or delete the symlink).
Repository layout
index.ts the extension (single file, loaded by Pi)
package.json npm packaging (pi.extensions entry, explicit files whitelist)Related
cp-pi-conv— an equivalent bash CLI kept on PATH for manual/non-pi use; this extension is the native pi implementation and is what pi configuration uses.
