rpiv-todo

Todo overlay extension for Pi CLI agent — visual task tracking in TUI with Claude-Code parity

Package details

extension

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

$ pi install npm:rpiv-todo

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

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

Task overlay extension for Pi Agent — visual task tracking in the TUI with persistent overlay widget, priority management, and Claude-Code parity.

todo tool — full CRUD for tasks with 4-state lifecycle (pending → in_progress → completed, plus deleted)
/todos command — print current task list grouped by status
TodoOverlay widget — persistent TUI overlay above the editor, auto-renders when tasks exist
Branch replay persistence — tasks survive session compact and /reload via branch replay
Dependency tracking — blockedBy with cycle detection
Priority management — assign and filter tasks by priority
Smart overflow — 12-line collapse threshold; completed tasks drop first, pending tasks truncate last
Auto-hide — overlay disappears when the task list is empty

pi install npm:rpiv-todo

Then restart your Pi session.

Add to your settings.json packages array:

{
  "packages": [
    "npm:rpiv-todo"
  ]
}

Agent prompt reference: AGENTS.md

Add the git URL to your settings.json packages array:

{
  "packages": [
    "https://github.com/buihongduc132/rpiv-todo"
  ]
}

Create, update, list, get, delete, or clear tasks. The 4-state machine:

pending → in_progress → completed
                      ↘ deleted (tombstone)

Supports blockedBy dependency tracking with cycle detection.

Print the current todo list grouped by status.

The aboveEditor widget auto-renders whenever any non-deleted tasks exist. It:

npm install
npm test