@aalalice233/pi-goal-x
Adds persistent goal management to the pi coding agent
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: @aalalice233/pi-goal-x. It is used for: Adds persistent goal management to the pi coding agent Full Skill content: https://321skill.com/skills/aalalice233-pi-goal-x/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 issues of goals being easily lost, task progress lacking transparency, and the inability to continuously track long-term objectives during AI-assisted coding. In practical development, developers often need the AI agent to remember a long-term goal (e.g., 'refactor the user module'), but regular conversations can easily cause goal drift, leading the agent to forget the current task's focus. pi-goal-x ensures the agent consistently executes around the established goal through persistent goal logging, a status overlay, and an automatic continuation mechanism.
Usage is straightforward: simply initialize the extension in your project, then draft a goal using the /goal-set command. The system will prompt a structured dialog for confirmation. Afterward, you can use natural language instructions to 'draft a task list', 'complete tasks', 'pause/resume goals', etc. All operations are synchronized to the status overlay above the editor for constant visibility. For goals requiring verification, you can add a Verification contract: block to the draft. The agent must provide a verification summary upon completion; otherwise, it cannot proceed.
It is well-suited for teams or individuals handling continuous, multi-step coding tasks. This is especially true for developers already using the pi coding agent for daily development, such as large-scale refactoring, feature development, code reviews, or other work requiring multiple sessions. It also fits teams with strict auditing needs, as each goal completion includes a verification summary for traceability.
It is recommended to adopt this tool uniformly before starting a well-defined, long-term task. Note that it primarily relies on the pi framework, and upstream features are still evolving. Regularly merging upstream changes is advised to access new functionalities. Also, subtask recursion depth is limited to one level by default, which can be adjusted via the configuration file to avoid management complexity from overly deep nesting.
Key Features
Unlike the upstream `@capyup/pi-goal`, pi-goal-x introduces a verification contract system that requires the agent to provide a compliant verification summary upon goal completion; otherwise, the call is rejected. Additionally, it supports atomic creation of goals and task lists (a single confirmation creates both the goal and tasks), whereas the original version requires two separate calls.
Limitations
Must run within the pi coding agent framework and does not support other AI agent platforms; subtask recursion depth is limited to one level by default, requiring manual configuration file modification for deeper nesting.
FAQ
How do I install pi-goal-x?
Clone the repository locally via git clone, then load it following the pi extension installation method (typically by placing the extension directory into pi's extensions directory).
What's the difference from the upstream pi-goal?
pi-goal-x adds features like verification contracts, unified goal+task acceptance, recursive subtasks, lightweight subtask markers, and completion auditor integration, while retaining all core functionalities of the upstream version.
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/aalalice233-pi-goal-x/raw/index.md to read the original Skill definition (Markdown format) for @aalalice233/pi-goal-x, and install it according to the instructions.
Raw Markdown URL for AI: /skills/aalalice233-pi-goal-x/raw/index.md