@leo-alvarenga/pi-todo-list

Session-aware todo list overlay for Pi: todo tool, /todos command, and a live TUI panel

Packages

Package details

extension

Install @leo-alvarenga/pi-todo-list from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@leo-alvarenga/pi-todo-list
Package
@leo-alvarenga/pi-todo-list
Version
0.6.3
Published
Sep 18, 2026
Downloads
920/mo · 186/wk
Author
leo-alvarenga
License
MIT
Types
extension
Size
26.3 KB
Dependencies
1 dependency · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@leo-alvarenga/pi-todo-list

Session-aware todo list overlay for the Pi coding agent. The agent manages tasks with a todo tool while you watch them live in a panel above the input editor.

Features

  • todo tool — the agent can add tasks, update their status (pending → in-progress → completed), declare dependencies (blockedBy), remove, list, and clear. Invalid operations (unknown ids, self-blocks, dependency cycles) are rejected before any state change.
  • Live TUI panel above the input editor — a header line with a collapse/expand chevron and per-status counters, Nerd Font status glyphs ( pending, 󱥸 in-progress,  completed), blocked-task hints, and a hardcoded 8-row budget with a … +N more summary line. The panel hides itself entirely while the list is empty.
  • Toggle with Alt+T — collapsed by default; collapsed shows just the header line.
  • /todos command — prints the full list grouped by status straight to the terminal transcript.
  • Batch operations — todo add accepts a texts array to add many at once, and todo remove accepts an ids array to remove many at once.
  • todo_complete_all tool — marks every todo completed and clears the list in one call, telling you how many items were completed.
  • Session-isolated state — each session has its own list; it survives /reload and context compaction with no external files, because state is replayed from the session branch (tool results + custom entries), never written by the extension itself.
  • No configuration, no localization — all limits are hardcoded constants and all text is English.

Install

pi install npm:@leo-alvarenga/pi-todo-list

or add the local path / npm spec to your project .pi/settings.json, then run /reload.

Usage

Tell the agent: "track these tasks as todos: …", or use the tool directly:

  • todo add with text
  • todo update with id and optional status / text / blockedBy
  • todo remove / todo list / todo clear

Run /todos yourself at any time to see the full grouped list.

Keybinding

Alt+T toggles the panel. If your terminal intercepts that chord (e.g. GNOME Terminal opens a new tab), pick a free one and change PANEL_TOGGLE_CHORD in src/constants.ts.

License

MIT — see LICENSE. Copyright (c) 2026 Leonardo A. Alvarenga.