@matthewlam/pi-goal
Persistent goal mode for pi with automatic idle continuation
Package details
Install @matthewlam/pi-goal from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@matthewlam/pi-goal- Package
@matthewlam/pi-goal- Version
0.1.2- Published
- May 30, 2026
- Downloads
- not available
- Author
- matthewlam
- License
- MIT
- Types
- extension
- Size
- 39.5 KB
- Dependencies
- 0 dependencies · 2 peers
Pi manifest JSON
{
"extensions": [
"./extension/index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-goal
Persistent goal mode for pi. Set a long-running objective with /goal; pi keeps working on it across idle turns until the model marks the goal complete or blocked.
Install
pi install npm:@matthewlam/pi-goal
Or from git:
pi install git:github.com/minghinmatthewlam/pi-goal
Usage
/goal ship the auth refactor and verify it in the running app
/goal pause
/goal resume
/goal complete
/goal clear
The extension also exposes model-callable tools:
| Tool | Description |
|---|---|
get_goal |
Inspect the current goal and usage. |
create_goal |
Create a new active goal when the user explicitly asks. |
update_goal |
Mark the active goal complete/achieved or blocked. |
How It Works
pi-goal stores goal state in the session, shows active goal status in extension UI, and schedules a hidden continuation message when pi is idle. The continuation prompt is only injected if the active goal still matches, so stale continuations cannot keep working on an old goal after pause, clear, or replacement.
License
MIT