@spences10/pi-recall

Pi extension that syncs pirecall and nudges agents to query past Pi sessions when history matters

Packages

Package details

extension

Install @spences10/pi-recall from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@spences10/pi-recall
Package
@spences10/pi-recall
Version
0.0.16
Published
Jul 20, 2026
Downloads
723/mo · 42/wk
Author
spences10
License
MIT
Types
extension
Size
31.9 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ],
  "image": "https://raw.githubusercontent.com/spences10/my-pi/main/assets/pi-package-preview.png"
}

Security note

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

README

@spences10/pi-recall

built with Vite+ tested with Vitest npm version license

my-pi package preview

Find the old decision, bugfix, or implementation detail instead of rediscovering it. pi-recall keeps pirecall synced and reminds the model to query past Pi sessions when history would save time or avoid repeated work.

Installation

pi install npm:@spences10/pi-recall

Local development from this monorepo:

pnpm --filter @spences10/pi-recall run build
pi install ./packages/pi-recall
# or for one run only
pi -e ./packages/pi-recall

What it does

  • runs npx pirecall sync --json in the background on session start when ~/.pi/pirecall.db exists
  • runs npx pirecall sync --json again on session shutdown
  • injects a system reminder telling the model to use pnpx pirecall ... --json or npx pirecall ... --json
  • adds /resume-recall [query], a SQLite-backed searchable and paged picker for live session files
  • keeps Pi's native /resume unchanged as the fallback

The recall picker uses pirecall only for discovery. Before opening a selection it checks that the JSONL still exists, then delegates the actual switch to Pi's session runtime and SessionManager lifecycle.

Model reminder

The injected reminder tells the model to use pirecall when:

  • the user references prior work
  • previous session context would prevent repeated work
  • project history or decisions matter

Useful commands:

pnpx pirecall sync --json
pnpx pirecall recall "auth refactor" --json
pnpx pirecall search "prompt presets" --json
pnpx pirecall sessions --json
pnpx pirecall stats --json

To find and resume a live session interactively:

/resume-recall
/resume-recall auth refactor

Use npx instead of pnpx outside pnpm-oriented environments. If the pirecall index or resumable API is unavailable, use Pi's native /resume picker.

Using from a custom harness

import recall from '@spences10/pi-recall';

// pass `recall` as an ExtensionFactory to your Pi runtime

my-pi imports this package directly and enables it as the built-in recall reminder.

Development

Package scripts build transitive workspace dependencies first, then run local tools through Vite+ with vp exec.

pnpm --filter @spences10/pi-recall run check
pnpm --filter @spences10/pi-recall run test
pnpm --filter @spences10/pi-recall run build

License

MIT