@redentor_dev/pi-goal

Minimal goal tracking and auto-continuation for pi: start a goal, resume it, check progress.

Packages

Package details

extensionskill

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

npm repo home report

$ pi install npm:@redentor_dev/pi-goal

Package: @redentor_dev/pi-goal
Version: 0.1.2
Published: Jul 4, 2026
Downloads: 389/mo · 27/wk
Author: redentor_dev
License: MIT
Types: extension, skill
Size: 25.7 KB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

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

README

Pi Goal

Minimal goal tracking and auto-continuation for Pi: start a goal, pause/resume it, check progress, and let the agent continue until it calls the completion tool.

Published npm package: @redentor_dev/pi-goal.

Install

From npm:

pi install npm:@redentor_dev/pi-goal

Commands

/goal <objective> — start a new goal and immediately kick off work.
/goal --tokens 50k <objective> — start with a token budget (k and m suffixes supported).
/goal or /goal status — show objective, status, iteration, token use, and active time.
/goal pause — pause the active goal and stop auto-continuation.
/goal resume — resume a paused or budget-limited goal and queue the next continuation.
/goal clear or /goal stop — clear the current goal and remove the footer status.

How it works

Goal state is persisted only as Pi session custom entries (pi-goal); no external state files are written.
When the agent finishes a turn while a goal is active, the extension queues one follow-up user message to continue work.
Optional token budgets stop continuation with budget_limited status. Budget exhaustion never marks the goal complete.
Reloading, resuming, or otherwise starting a session with an active stored goal pauses it first. Use /goal resume to continue intentionally.
The footer shows compact status such as goal: active 18k/100k, goal: paused, or goal: budget-limited.

`complete_goal` tool

The package registers one tool: complete_goal.

The agent should call it with { "summary": "..." } only after an evidence-backed audit proves the objective is fully satisfied. The prompt contract tells the agent not to use passing tests, elapsed effort, low budget, or partial progress as completion by themselves.

Compatibility

Works alongside @redentor_dev/pi-orchestrator. The packages have no shared dependency, and this package uses only /goal and complete_goal, avoiding /team, delegate_researcher, delegate_implementor, delegate_design, and review_diff.

Credits

Prior art and design references:

Michaelliv/pi-goal
@narumitw/pi-goal
pi-codex-goal