omp packages

pi-reset0.3.0

Pi extension providing /reset and agent-callable reset and quit tools

thealokkr Published 7 days ago MIT ~673 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

pi-reset

A lightweight Pi extension that provides a /reset command along with agent-callable reset and quit tools for interactive and multi-session workflows.

Why pi-reset?

  1. Clear context without losing your setup: Pi's built-in /new command clears the conversation context, but it also resets your selected model and thinking level back to defaults. /reset starts a fresh session (and retains the previous transcript) while preserving your provider, model, thinking level, and session name.
  2. Orchestrator-driven session resets: When one Pi session acts as an orchestrator managing worker sessions, it needs a way to clear a worker's context between tasks. Because reset is also registered as an agent-callable tool, an orchestrator can instruct another session to reset itself before starting a new task.
  3. Programmatic session shutdown: Pi's built-in /quit slash command cannot be invoked programmatically by an agent. The quit tool gives agents a clean way to shut down gracefully—for example, allowing an orchestrator to tell a planner or worker session to exit once its job is done.

What's Included

Feature Type Description
/reset Slash Command Clears conversation context like /new, while keeping provider, model, thinking level, and session name.
reset Agent Tool Agent-callable twin of /reset. Waits for the agent to become idle before starting the fresh session.
quit Agent Tool Agent-callable twin of /quit. Requests a graceful shutdown once the current turn finishes.

Installation

pi install npm:pi-reset

For local development and testing:

pi -e .

Usage

  • Interactive: Run /reset in the prompt to start fresh without re-selecting your model or thinking level, or /quit to exit.
  • Agent / Orchestrator: Ask the agent to call the reset tool before switching to an unrelated task, or the quit tool when a session has completed its assigned role.