@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.