pi-goal

Codex-like /goal command for pi — autonomous goal tracking with continuation loops.

Install

pi install https://github.com/zereraz/pi-goal

Or temporarily:

pi -e git:github.com/zereraz/pi-goal

How it works

/goal Refactor auth module to use JWT

1. Sets the goal and sends the objective to the agent
2. Agent works on it, finishes the turn
3. After 2s idle, a continuation prompt auto-sends — agent keeps going
4. Loop continues until the agent calls update_goal(status: "complete") or you /goal pause

The agent sees the goal in its system prompt every turn, gets update_goal and get_goal tools, and receives a structured continuation prompt (ported from Codex) with objective, budgets, and completion audit instructions.

Commands

Command	Action
/goal <objective>	Set goal, start working
/goal <objective> --budget 50k	Set goal with token budget
/goal	Interactive status menu
/goal pause	Pause (stops continuation)
/goal resume	Resume (restarts continuation)
/goal clear	Remove goal
/goal status	Show status

What the agent gets

• System prompt: Goal objective, status, time/token budget injected each turn
• update_goal tool: Mark goal complete — pause/resume are user-controlled
• get_goal tool: Read current goal status and budgets
• Continuation prompt: Budget info + completion audit checklist (from Codex)
• Budget limit: When token budget exceeded, goal auto-pauses with wrap-up instructions

Footer status

🎯 Refactor auth module to... [2m • 1.5K/50K]
⏸ Refactor auth module to... (paused)
⚠️ Refactor auth module to... (budget limited)