@cheetahbyte/pi-todo
Pi extension that gives the agent a todo tool with a task graph and a /todos view.
Package details
Install @cheetahbyte/pi-todo from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@cheetahbyte/pi-todo- Package
@cheetahbyte/pi-todo- Version
0.3.0- Published
- Oct 4, 2026
- Downloads
- 181/mo · 14/wk
- Author
- cheetahbyte
- License
- MIT
- Types
- extension
- Size
- 23.9 KB
- Dependencies
- 0 dependencies · 2 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
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-todoThis 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.