pix-todo

Pi tool — durable execution checklist (todo).

What it does

Registers the todo tool, which gives the agent a persistent task checklist that survives context compaction and session restore. The checklist is seeded by the model via the set action and tracks items through four statuses: pending (○), in_progress (◐), done (●), and blocked (⊘). State is persisted via Pi's appendEntry("todo-state") so the agent can recover its position after long runs or compaction events. The agent calls todo(action:"list") to resume where it left off. Actions: list, set, add, update, clear.

While the checklist is non-empty, a compact progress segment (◐ 1/3, ● 3/3, ⊘ 0/2 !2) is published to the TUI footer via ctx.ui.setStatus("todo", …) so it stays visible after the tool card collapses. The segment is restored on session start and cleared when the list is empty.

Auto-collapse

The checklist card uses the shared @dihak/pix-data/collapse state machine and auto-collapses after a configurable delay (default 10 seconds) to a row such as ✓ todo #2 release prep · 1/2 done. Expanding an elapsed card restores the immutable checklist snapshot for that result, with its colored status glyphs, without restarting the timer. Failed actions keep their exact diagnostic instead of rendering a checklist. The delay and per-tool toggle are read from ~/.pi/agent/pix.json:

{
  "collapse": {
    "enabled": true,
    "delaySec": 10,
    "tools": { "todo": true }
  }
}

Set collapse.tools.todo: false to keep the checklist always expanded. See @dihak/pix-data/collapse for the full API.

Install

pi install npm:@dihak/pix-todo

Also included in @dihak/pix-core:

pi install npm:@dihak/pix-core

Full distro

Source: github.com/dihak/pix-mono

To install the complete pix suite (all packages + Pi itself):

curl -fsSL https://raw.githubusercontent.com/dihak/pix-mono/main/scripts/install.sh | sh

License

MIT