pi-codex-goal adds a persistent goal to Pi. The extension prompts Pi to continue an active goal across turns.
Use Pi 1.0.0 or later and Node.js 24 or later. The extension supports official Pi releases and the fitchmultz Pi fork.
pi install npm:pi-codex-goal
piRun /reload if Pi is already open. Enter a task in the Pi editor:
/create-goal Add CSV export to the reports page. Test the export. Document its use.
/create-goal expands your task into an objective with completion checks. The new goal replaces the old one. Include every requirement you want to keep.
| Command | Action |
|---|---|
/goal |
Show the objective, status, token budget, usage, and active time. |
/goal <objective> |
Set the exact objective. Confirm replacement of an unfinished goal. |
/goal pause |
Pause an active or waiting goal. |
/goal resume |
Continue a paused, blocked, or waiting goal. |
/goal resume cancel |
Cancel a scheduled provider-limit retry. |
/goal copy |
Copy the objective to the system clipboard. |
/goal clear |
Remove the current goal. |
Press Esc to stop the current assistant turn and pause its active goal.
Goal-generated follow-ups are hidden custom messages, not editable user input. Alt+Up restores only genuine queued user text, never automated Goal instructions. Use the commands above to pause, resume or replace automated work. Genuine input, image attachments and existing editor drafts keep Pi's native editing behavior.
A blocked goal needs input or external work. Run /goal to read the reason. Resolve the dependency. Run /goal resume.
For background jobs that deliver their own result messages, the agent can set the goal to waiting with a reason naming the work. Waiting stops hidden continuations and active-time accounting without polling. New user input, steering, or another extension's result automatically reactivates the goal; /goal resume also works. /goal pause keeps it paused even when a result arrives.
Completed goals stay complete. Create a new goal for more work.
Active goals cause extra model calls. Use /goal pause to stop automatic continuation.
New goals have no token limit. Ask the agent to set token_budget through create_goal to limit a goal. The default minimum is 500,000 tokens. The goal stops automatic continuation when it reaches the budget.
Goal tokens count assistant input and output. This count excludes provider cache accounting and host maintenance costs. It does not show total provider charges.
The goal survives resume, reload, fork, tree navigation, and compaction. The Pi footer shows goal status and usage when a UI is available. In the terminal UI, a separate line below the editor shows the unfinished goal's status and objective. Long or multiline objectives are condensed to one truncated line; run /goal for the full text. Completing or clearing the goal hides this line.
Pi controls compaction. The extension uses bounded retries for transient provider errors. Recognized provider usage limits can schedule an automatic retry.
Automated Goal follow-ups do not reset exhausted native context-overflow recovery. Goal pauses with an explanation instead of forcing another attempt. Reduce context or switch models, send a genuine user message to get native user recovery, then run /goal resume.
Ask the agent to use create_goal, get_goal, and update_goal for headless runs.
pi -p '/goal …' runs the command and can change saved goals. Print mode can exit before the goal turn finishes and leave the goal paused.
Read the reference for installation options, budget policy, tools, and recovery.
Read the development guide for checks, compatibility qualification, smoke tests, and releases.
See the changelog for version history. Report problems in Issues.
Mitch Fultz publishes this project under the MIT license.