pi-mono-goal

Pi extension for Codex-style persistent session goals and bounded auto-continuation

Packages

Package details

extension

Install pi-mono-goal from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-mono-goal
Package
pi-mono-goal
Version
0.2.0
Published
Aug 21, 2026
Downloads
157/mo · 33/wk
Author
emanuelcasco
License
unknown
Types
extension
Size
37.2 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-mono-goal

Codex-style session goals for pi.

The extension adds a persistent /goal command, model tools, hidden goal steering, bounded auto-continuation, usage accounting, and a small status/widget UI.

Usage

/goal migrate TargetTracking to features
/goal show
/goal edit migrate TargetTracking and update imports
/goal update moved components; next run tests
/goal pause
/goal resume
/goal auto on
/goal budget turns 10
/goal done implemented and tested
/goal clear

Modes:

  • manual: persist and display the goal only.
  • assist: inject hidden goal steering on user turns.
  • auto: assist mode plus bounded automatic continuation after agent_end.

Auto mode defaults to 10 assistant turns and 30 minutes unless overridden.

Tools

  • get_goal — inspect current goal, progress, budgets, accounting, and optional history.
  • create_goal — create/formalize a goal, optionally replacing an active goal.
  • update_goal — update progress, next action, plan, blockers, status, mode, and budgets.

Persistence

Goal state is append-only in Pi session custom entries (goal-event), so it survives reload/resume and follows the active conversation branch.