@zjie-wang/pi-todo

Session-persistent multi-phase todo tracker with a live Pi TUI widget

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@zjie-wang/pi-todo

Package: @zjie-wang/pi-todo
Version: 0.2.1
Published: Oct 19, 2026
Downloads: 222/mo · 164/wk
Author: zjie-wang
License: MIT
Types: extension
Size: 78.3 KB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "image": "https://raw.githubusercontent.com/ZJie-Wang/pi-extensions/main/extensions/todo/screenshot.png",
  "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 todo tracker lives in the session.

What the user sees

todo widget

What the model sees

Tool definition (request payload):

{
  "name": "todo",
  "description": "Track complex work in phases.",
  "parameters": {
    "type": "object",
    "required": ["action"],
    "properties": {
      "action": {
        "type": "string",
        "enum": ["set", "update"],
        "description": "set creates or replaces the tracker and activates its first phase; update completes and/or activates phases."
      },
      "items": {
        "type": "array",
        "items": { "type": "string" },
        "description": "Ordered phase titles. Required for set."
      },
      "completeIds": {
        "type": "array",
        "items": { "type": "integer" }
      },
      "activateIds": {
        "type": "array",
        "items": { "type": "integer" }
      }
    },
    "additionalProperties": false
  }
}

System prompt guidance — this extension's contribution, alongside the other tools in the session:

Available tools:
- todo: Track multi-phase progress

Guidelines:
- Use todo for complex work with 3+ meaningfully coordinated phases. Once a tracker is set, remember to update it in real time.

Install

pi install npm:@zjie-wang/pi-todo