@4fu/pi-todo
A conversation-aware tool for managing tasks and checklists in pi
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: @4fu/pi-todo. It is used for: A conversation-aware tool for managing tasks and checklists in pi Full Skill content: https://321skill.com/skills/4fu-pi-todo/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
This Skill addresses the issue of being unable to persistently track task progress within AI coding sessions. In real-world development, developers often need to manage to-dos across multiple conversation branches, but standard to-do tools either modify the original text or lose context, leading to progress confusion.
Usage is straightforward: you simply use a todo tool with five actions: create to make a task (supporting multi-level checklists), list to view pending tasks or details of a single task, add to append progress updates, complete to mark a task as done, and cancel to cancel a task. You can then manage tasks using natural language instructions. All data is automatically saved within the current conversation branch, and progress automatically follows when you switch branches.
It's ideal for teams or individuals who frequently switch development branches and manage multiple parallel tasks. This is especially useful for users who already employ pi as an AI coding agent, allowing them to track task status without leaving the conversation and avoid context loss.
We recommend using this tool to create task checklists when starting new feature development or project iterations. Note that it primarily relies on pi's conversation branch mechanism; task data is not written to project files or global storage, making it unsuitable for scenarios requiring long-term persistence across separate sessions.
Key Features
Unlike standard to-do tools (e.g., Todoist, Notion tasks), it does not modify the original text content. All progress is stored within pi's conversation branches via tool result events, automatically restoring when switching branches, eliminating the need for manual synchronization.
Limitations
Requires Node.js 22.19 or higher and must run within the pi environment. It cannot be used standalone or integrated with other AI platforms.
FAQ
Where is the task data stored?
Task data is stored in the tool result events of the current pi conversation branch. It automatically restores when switching branches and is not written to project files or global storage.
How do I view completed tasks?
Using the `list` action displays a list of pending tasks and summarizes the count of completed tasks in the final line. Using `list` with a task ID shows the complete progress history for that individual task.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/4fu-pi-todo/raw/index.md to read the original Skill definition (Markdown format) for @4fu/pi-todo, and install it according to the instructions.
Raw Markdown URL for AI: /skills/4fu-pi-todo/raw/index.md