@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.

npm repo home report

$ pi install npm:@robhowley/pi-remembrancer

Package: @robhowley/pi-remembrancer
Version: 0.5.0
Published: Nov 13, 2026
Downloads: 651/mo · 334/wk
Author: robhowley
License: MIT
Types: extension, skill
Size: 160.8 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 reviews user and assistant messages from 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

Automatic TODO suggestions

Save task suggestions when you leave a session, without asking for a review each time. Capture never changes your Taskwarrior tasks; you approve suggestions later in Saved proposals.

Capture is off by default. To enable it, add this to Pi's global settings file, normally ~/.pi/agent/settings.json:

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

What to expect

When: your interactive session ends.
Scope: the session you're leaving, but only messages that haven't yet been reviewed.
Model: your session's selected model
Result: proposals and review progress are saved together. Open /remembrancer proposals to review them.

Saved proposals

Review the suggestions saved by automatic capture in Pi's interactive terminal:

/remembrancer proposals

At startup, a reminder such as 3 task proposals · /remembrancer proposals shows how many pending items await review.

Select an item to see its proposed changes, current task, explanation, and saved quotes.

Key	Action
↑ / ↓	Select a proposal from the preview.
Page Up / Page Down	Scroll details.
`Ctrl+A`	Approve and apply the displayed proposal.
`e`	Edit and save a pending proposal's JSON draft, without changing tasks.
`d`	Dismiss a pending proposal.
`s`	View surrounding source context.
`h`	View the saved proposal and revision history.
Esc	Return from Source/History to the preview, then close.

Track task blockers

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.

Settings

Remembrancer is enabled by default. Turn off remembrancer at any time by adding this to Pi's global settings file, normally ~/.pi/agent/settings.json:

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