@diegopetrucci/pi-todo

A pi extension that adds a branch-aware todo tool and /todos viewer.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@diegopetrucci/pi-todo
Package
@diegopetrucci/pi-todo
Version
0.1.2
Published
Jun 1, 2026
Downloads
250/mo · 163/wk
Author
diegopetrucci
License
MIT
Types
extension
Size
10.8 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "index.ts"
  ]
}

Security note

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

README

todo

A pi extension that adds a branch-aware todo list managed by the agent.

This started from the original todo.ts example in earendil-works/pi-mono, with small packaging and snapshot-safety tweaks.

What it adds

  • a todo tool for the agent to list, add, toggle, and clear todos
  • a /todos command for users to view todos on the current branch
  • todo state stored as snapshots in tool result details, so session branches reconstruct the right todo list for that point in history

Install

Standalone npm package

pi install npm:@diegopetrucci/pi-todo

Collection package

pi install npm:@diegopetrucci/pi-extensions

GitHub package

pi install git:github.com/diegopetrucci/pi-extensions

Then reload pi:

/reload

Notes

  • Hooks session_start and session_tree to reconstruct branch-local todo state.
  • The todo tool supports list, add, toggle, and clear actions.
  • The /todos command opens an interactive viewer and requires UI mode.