@cheetahbyte/pi-todo0.3.0
Pi extension that gives the agent a todo tool with a task graph and a /todos view.
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
Pi todo
@cheetahbyte/pi-todo gives the agent a todo tool for tracking multi-step work, and adds /todos so you can see the list.
Install
pi install npm:@cheetahbyte/pi-todo
This package is part of Pi kit. If you install the kit, don't install this package separately.
The todo tool
The agent calls todo with one of these actions:
| Action | What it does | Required fields |
|---|---|---|
create |
Adds one task. | subject |
createMany |
Adds several tasks in one call. | tasks |
update |
Changes a task's fields, status, or dependencies. | id and at least one field |
get |
Returns one task. | id |
list |
Returns all tasks. Set includeDeleted to include deleted ones. |
None |
delete |
Marks a task as deleted. | id |
clear |
Removes all tasks. | None |
A task has a subject and can have a description, an activeForm, an owner, metadata, and a blockedBy list of task IDs.
Task status
A task is pending, in_progress, completed, or deleted. Only these changes are allowed:
| From | To |
|---|---|
pending |
in_progress, completed, deleted |
in_progress |
pending, completed, deleted |
completed |
deleted |
deleted |
None |
Dependencies
blockedBy lists the tasks that must finish first. Use addBlockedBy and removeBlockedBy with update to change it. The tool rejects a dependency on a missing or deleted task, on the task itself, and any change that would create a cycle.
Show the list
Run /todos to see the tasks grouped by status, with a count of completed tasks. The command requires interactive mode.
Where tasks are stored
Tasks live in the session. The tool restores them from its own earlier results when a session starts, after compaction, and when you move to another branch of the session tree. Each branch therefore has its own task list.