omp packages

rpiv-todo1.1.0

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

buihongduc132 Published 5 months ago MIT ~370 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

rpiv-todo

License: MIT npm version GitHub

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

Features

  • 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

Installation

For Humans

pi install npm:rpiv-todo

Then restart your Pi session.

For AI Agents

Add to your settings.json packages array:

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

Agent prompt reference: AGENTS.md

For Pi git-sourced

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

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

Usage

Tool: 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.

Command: /todos

Print the current todo list grouped by status.

Overlay Widget

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

  • Collapses at 12 lines, dropping completed tasks first
  • Truncates pending tasks last on overflow
  • Auto-hides when the list is empty

Development

npm install
npm test

License

MIT © 2025 buihongduc132