pi-echo-todos
A general-purpose, model-callable todo list (todo_write) rendered as a persistent widget
Package details
Install pi-echo-todos from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-echo-todos- Package
pi-echo-todos- Version
0.1.0- Published
- Aug 15, 2026
- Downloads
- 145/mo · 12/wk
- Author
- hegdesumanth.dev
- License
- unknown
- Types
- extension
- Size
- 6 KB
- Dependencies
- 2 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"."
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-echo-todos
A general-purpose, model-callable todo list — independent of pi-echo-plan-mode's own todo tracking (which only exists during plan-mode execution).
Design note
Uses pi.registerTool() for the whole-list-replace todo_write tool and ctx.ui.setWidget()/ctx.ui.setStatus() for persistent rendering — both plain Pi primitives, nothing new invented. State is session-scoped, persisted via pi.appendEntry() and restored on session_start, the same pattern pi-echo-plan-mode uses. Deliberately does not hard-block on "more than one in_progress item" — surfaced as a note in the tool result, not a rejected call.
Usage
The model calls todo_write({todos: [...]}) with the full list every time (not a diff); an empty array clears it. /todo shows the current list on demand; the widget stays visible above the editor as long as the list is non-empty.