@wayofmono/pi-todo

Session-scoped todo list with 4 statuses and 3 priorities for Pi Coding Agent.

Install

pi install npm:@wayofmono/pi-todo

Restart your Pi session.

Quick Start

Run /todos after restart to open the interactive todo panel. On a fresh session it shows:

No todos.

Then ask the agent to create todos: "Add a repository layer with tests, track it as todos". The model calls the todo tool and the panel appears above the editor.

Features

• 4 statuses: pending, in_progress, completed, cancelled
• 3 priorities: high, medium, low
• Survives /reload and compaction — state rebuilt from session branch
• Interactive panel — press Ctrl+C or Escape to close
• Single in-progress enforcement — model auto-resets previous in-progress

Commands

Command	Description
/todos	Open interactive todo panel

Tool: todo

Action	Parameters	Description
list	—	List all todos
add	content, priority?	Add new todo
update	index, status?, priority?, content?	Update todo
remove	index	Remove todo
clear	—	Clear all todos
replace	todos[]	Replace entire list

Status values

• pending (○) — default
• in_progress (►) — auto-clears other in_progress
• completed (✓) — done
• cancelled (✗) — abandoned

Priority values

• high (HIGH)
• medium (med) — default
• low (low)

Example Usage

// Add a todo
await todo({ action: "add", content: "Write tests", priority: "high" })

// Mark in progress
await todo({ action: "update", index: 0, status: "in_progress" })

// Complete it
await todo({ action: "update", index: 0, status: "completed" })

How It Works

State is stored in session entries (tool results). On session_start and session_tree, the extension replays the branch and reconstructs the todo list from the latest todo tool result. No disk writes — survives /reload and compaction automatically.

License

MIT