@juicesharp/rpiv-todo

Pi extension: gives the model a todo list with a live overlay that survives /reload and compaction

Package details

← Back
extension

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

npm repohome report
$ pi install npm:@juicesharp/rpiv-todo
Package
@juicesharp/rpiv-todo
Version
1.1.4
Published
May 3, 2026
Downloads
8,848/mo · 4,865/wk
Author
juicesharp
License
MIT
Types
extension
Size
61 KB
Dependencies
0 dependencies · 5 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

rpiv-todo

npm version License: MIT

Give the model a todo list it can keep across long sessions. rpiv-todo adds the todo tool, the /todos slash command, and a live overlay above the editor to Pi Agent — tasks survive /reload and conversation compaction, so the model picks up where it left off.

Todo overlay widget above the Pi editor

Features

  • Live overlay above the editor — see the model's plan at all times; auto-hides when empty.
  • Survives /reload and compaction — tasks replay from the conversation branch, not disk.
  • Status states — pending, in_progress, completed, plus a deleted tombstone for audit.
  • Dependency tracking — blockedBy with cycle detection, so the model can sequence work.
  • Smart truncation — 12-line collapse threshold; completed tasks drop first, pending tasks stay visible last.

Install

pi install npm:@juicesharp/rpiv-todo

Then restart your Pi session.

Optional: localization

rpiv-todo works standalone — install only this package and you get the full English UI. Install @juicesharp/rpiv-i18n alongside it to flip the overlay heading, /todos section headers, and status words to your active locale:

pi install npm:@juicesharp/rpiv-i18n

With the SDK present, locale resolves from --locale <code> → ~/.config/rpiv-i18n/locale.json → LANG / LC_ALL → English. The /languages interactive picker and pi --locale <code> startup flag are also enabled. Without the SDK, the extension stays online and renders English at every call site — no warning, no crash. Users who installed via pi install npm:@juicesharp/rpiv-pi + /rpiv-setup get the SDK automatically.

Tool

  • todo — create / update / list / get / delete / clear tasks. 4-state machine (pending → in_progress → completed, plus deleted tombstone). Supports blockedBy dependency tracking with cycle detection. Tasks persist via branch replay — survive session compact and /reload.

Commands

  • /todos — print the current todo list grouped by status.

Overlay

The aboveEditor widget auto-renders whenever any non-deleted tasks exist. 12-line collapse threshold; completed tasks drop first on overflow, pending tasks truncate last. Auto-hides when the list is empty.

Localization

rpiv-todo localizes its TUI chrome (overlay heading, /todos section headers, status words) through @juicesharp/rpiv-i18n when the SDK is installed. Bundled locales: de, en, es, fr, pt, pt-BR, ru, uk. LLM-facing output (tool response envelope, reducer errors, schema descriptions) stays English by design.

The SDK is a soft optional peer — rpiv-todo loads it via dynamic import at module init. If the SDK isn't installed, every render call site returns its inline English fallback and the extension stays online with English UI; no warning, no crash. See the Install section for adding the SDK after the fact. To contribute or override translations, see the @juicesharp/rpiv-i18n README "Contributing translations" section.

License

MIT