@yandy0725/pi-todo

pi package providing a minimal todo tool with an editor-overhead widget

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@yandy0725/pi-todo
Package
@yandy0725/pi-todo
Version
0.1.1
Published
Jun 28, 2026
Downloads
311/mo · 14/wk
Author
yandy0725
License
MIT
Types
extension
Size
12.5 KB
Dependencies
0 dependencies · 2 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

pi-todo

A minimal pi package that adds a single todo tool with an editor-overhead widget for visual task tracking.

Features

  • One tool, three actions: set (plan all tasks), update (change one task), list (review progress)
  • 3 states: pending → in_progress → done
  • Dependencies: optional blockedBy array, with self-dependency and cycle detection
  • Compact widget above the editor: ○ pending · ◉ in_progress · ✓ done · 🔒 blocked
  • Branch-safe persistence: state is reconstructed from the session branch, so /fork and /resume keep the right todos

Install

pi install npm:@yandy0725/pi-todo

Or add to ~/.pi/agent/settings.json:

{
  "packages": ["npm:@yandy0725/pi-todo"]
}

Tool reference

todo(action: "set" | "update" | "list", items?, id?, status?, title?, blockedBy?)
  • set — replace the whole list with items (use at planning time)
  • update — update the task with id (status, title, blockedBy optional)
  • list — return the current list

The widget hides automatically when every task is done.