@robhowley/pi-remembrancer

Track and review commitments across Pi sessions to keep your personal Taskwarrior list current.

Packages

Package details

extensionskill

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

$ pi install npm:@robhowley/pi-remembrancer
Package
@robhowley/pi-remembrancer
Version
0.3.0
Published
Nov 7, 2026
Downloads
350/mo · 350/wk
Author
robhowley
License
MIT
Types
extension, skill
Size
89.1 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "skills": [
    "./skills/remembrancer"
  ],
  "extensions": [
    "./extensions/remembrancer"
  ]
}

Security note

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

README

pi-remembrancer

Remembrancer is an agent-powered personal task manager built on Taskwarrior. It reads your saved Pi sessions to find what you said you would do and what you have done since. It checks what is already on your list, then suggests new tasks, progress notes, and completions for you to review in one pass.

Remembrancer (noun) - an officer of the medieval English Exchequer who kept the memoranda rolls, a record of debts owed to the Crown and other unfinished business to bring back before the court.

Install

Requires Taskwarrior 3 (task on your PATH). If you do not already use it, install and initialize it. On macOS:

brew install task
task

Then install Remembrancer:

pi install npm:@robhowley/pi-remembrancer

Run /reload in Pi or start a new session.

First review

Optionally, build your initial todo list from your recent Pi sessions:

/remembrancer seed 14d

This starts with the past 14 days. Use any positive whole number of days, such as 30d.

Remembrancer checks your existing tasks and suggests additions, progress notes, and completions. Accept, edit, or dismiss the suggestions before anything is written.

Your tasks stay in Taskwarrior. Use task list or task completed any time.

Everyday examples

Explicit requests to add or change a task are applied directly after the actual record is checked. Changes inferred from your sessions need your approval.

Say this in Pi What happens
“Add ‘run the held-out comparison’ to work.ranking.” Check for a matching task and add the commitment.
“I’ll send the route after the school confirms pickup. Add that to life.bikebus.” Add “Send the route” with a waiting condition.
“The school confirmed pickup. Update my route todo.” Clear the waiting condition; sending the route stays pending.
“Wrap up this session.” Suggest new tasks, progress notes, and completions from this conversation.
“What changed since my last review?” Review new activity across saved sessions and suggest changes together.

The waiting-condition examples require the optional field below.

You can also invoke the skill directly:

/skill:remembrancer review commitments across my saved sessions

Optional waiting conditions

To record what a task is waiting on, add the waitingon field:

task config uda.waitingon.type string

Skip this setup if you do not need waiting conditions; other task operations work without it.

What gets reviewed

  • Regular reviews cover sessions opened or resumed with Remembrancer enabled. An older session included for the first time this way can bring in its full history; use seed to set a starting point instead.
  • Seed also searches Pi's configured session archive, including saved worker sessions. It does not reconstruct which sessions had Remembrancer disabled in the past.
  • A shorter seed duration does not narrow existing review coverage. Repeating a seed skips unchanged text that has already been reviewed.
  • Only user and assistant text is sent to the model in your reviewing session, not tool outputs, model thinking, or images.
  • Reviews run only when you ask. Activity added during a review waits for the next one.
  • If a session cannot be read, Remembrancer reports it and leaves it for a later review. Cancelling a review leaves review progress unsaved, but it does not undo task changes already applied.

Settings

Remembrancer is enabled by default. To turn off saved-session reviews and stop including newly opened or resumed sessions in future reviews, add this to Pi's global settings file, normally ~/.pi/agent/settings.json:

{ "pi-remembrancer": { "disabled": true } }

A trusted project's .pi/settings.json takes precedence over the global value. After changing settings, run /reload or start a new session. The skill remains available: direct task requests can still change Taskwarrior tasks.