pi-native-todo

Native task planning and state tracking for Pi with branch replay and a live TUI widget

Package details

extension

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

$ pi install npm:pi-native-todo

Pi manifest JSON

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

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

Native task planning and state tracking for Pi. Array-based, branch-replayable, and displayed in a live widget above the editor.

One tool — todo to read or replace the full task list
No IDs — no numbering, no nextId, no blockedBy
No action verbs — no create / update / delete. Pass the complete tasks array to set the list. Omit a task to remove it.
No background processes — no polling, no watchers, no timers
No files — state lives in toolResult.details, survives via session branch replay
Live widget — shows the current todo list above the editor with a progress bar

pi install npm:pi-native-todo

Then restart pi or run /reload.

Read current todo list:

todo({})

Replace the full todo list:

todo({
  "tasks": [
    { "content": "Do something", "status": "in_progress" },
    { "content": "Do something else", "status": "pending" }
  ]
})

Clear all tasks:

todo({ "tasks": [] })

The tool injects guidelines that ask the agent to:

Use todos only for non-trivial, multi-phase, dependent, or ambiguous work.
Keep steps short, concrete, ordered, and easy to verify.
Maintain exactly one in_progress task at a time.
Move tasks through pending → in_progress → completed without skipping states.
Update the plan immediately when the task structure changes.
Finish with every task completed or explicitly removed.

npm install
npm run check

Optimized the widget UI: progress bar with percentage, overflow indicator, and long-line truncation
Refined task rendering (strikethrough for completed, accent for in_progress)
Compact tool call and result display

MIT