Back to search
pi-goal
SkillGitHub
Persistent autonomous goals for pi
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/michaelliv--pi-goal)HTML
<a href="/listings/michaelliv--pi-goal"><img src="/api/listings/michaelliv--pi-goal/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
pi install npm:pi-goal
Or from git:
pi install git:github.com/Michaelliv/pi-goal
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 76 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # pi-goal
- 
- Persistent autonomous goals for [pi](https://github.com/badlogic/pi-mono).
- `pi-goal` adds a `/goal` command and goal tools so Pi can keep working toward a long-running, thread-scoped objective until the goal is complete, paused, cleared, or token-budget-limited.
- ## Install
- ```bash
- pi install npm:pi-goal
- ```
- Or from git:
- ```bash
- pi install git:github.com/Michaelliv/pi-goal
- ```
- ## Usage
- ```text
- /goal improve benchmark coverage until the suite has strong evidence
- /goal --tokens 50k finish the migration and verify tests
- /goal
- /goal status
- /goal pause
- /goal resume
- /goal clear
- /goal statusbar off
- ```
- When a goal is active, the extension shows compact visible lifecycle markers like `Goal active` and `Goal continuing`; expand them with `ctrl+o` to inspect the objective and usage. The full continuation instructions ride along as the content of that custom message, so the model always has the objective and audit guidance in the transcript while the renderer keeps the visible UI compact.
- The same Pi agent keeps running normal turns in the same session context until it calls `update_goal({ status: "complete" })`, the user pauses/clears it, or the token budget is reached. Reloading Pi pauses an active goal instead of silently resuming it; use `/goal resume` to continue.
- ## What it adds
- - `pi-goal-writer` skill: draft and review strong `/goal` objectives with evidence-based success criteria
- - `/goal [--tokens 50k] <objective>`: set or replace a goal
- - `/goal` or `/goal status`: show the current goal
- - `/goal pause`: stop autonomous continuation without deleting the goal
- - `/goal resume`: reactivate a paused goal
- - `/goal clear`: remove the goal
- - `/goal statusbar on|off`: show or hide the footer status line
- - `create_goal` tool: model can set or replace the current goal only when explicitly requested
- - `get_goal` tool: read current goal state
- - `update_goal` tool: model can only mark the goal `complete`
- - `get_goal` and `update_goal` are only exposed to the model while a goal is `active`; paused, cleared, complete, and budget-limited goals hide them so unrelated sessions are not tempted to call them
- - footer status: `Pursuing goal`, `Goal paused`, `Goal achieved`, or `Goal unmet`
- ## Flow
- ```text
- /goal <objective>
- -> persist goal in the current Pi session
- -> show compact Goal marker and footer status
- -> deliver continuation instructions as the marker's message content
- -> trigger an agent turn
- -> account time/tokens on turn_end
- -> queue another continuation on agent_end while active
- -> stop when update_goal marks complete, user pauses/clears, or budget is hit
- ```
- ## Completion behavior
- The model is instructed to audit completion against real evidence before calling `update_goal`. The `update_goal` tool deliberately accepts only `status: "complete"`; pausing, resuming, clearing, and budget limiting are controlled by the user or extension runtime. The final turn is still accounted even when the model completes the goal mid-turn.
- ## State
- Goal state is stored as Pi custom session entries with `customType: "pi-goal"`. It follows the active session branch, survives reloads, and does not require an external database.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.