omp packages

pi-tidy-context0.2.0

Pi package that watches context usage and triggers a tidy handoff before the window runs out.

GitHub Actions Published 7 days ago ~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-tidy-context

A Pi package that keeps long sessions tidy: it watches context usage and triggers a guided handoff before the window runs out, so state is summarized and carried over instead of being lost to compaction.

How it works

The package tracks context usage as a threshold percent of the model's context window, shown together with the estimated token count (used / total). When usage crosses the threshold, it prompts a tidy handoff: summarize decisions, open questions, and next steps so a fresh session can pick up cleanly.

  • Default threshold: 80% of the context window (with the estimated token count displayed alongside the percent).
  • The threshold is configurable; the token estimate is informational and does not change when the threshold percent changes.

Install

From npm (recommended):

pi install pi-tidy-context

Pin a version with pi install pi-tidy-context@X.Y.Z. See the releases page (or npm) for available versions. pi list shows the installed package; pi remove pi-tidy-context removes it.

Alternatively, install straight from git (no npm publish needed):

pi install git:github.com/nelsonPires5/pi-tidy-context@vX.Y.Z

Usage

Set the handoff trigger from inside Pi. Two modes:

/tidy-threshold 75    # percent mode: trigger at 75% of the context window
/tidy-threshold 150k   # tokens mode: trigger at ~150,000 tokens
  • Percent mode accepts a bare integer 1–100; tokens mode accepts <n>k (e.g. 150k, 200k). Anything else is rejected with a usage hint.
  • Tab-completion offers the current value plus presets (80, 90, 150k, 200k).
  • The threshold persists to ~/.pi/agent/handoff.json (overridable via PI_HANDOFF_CONFIG_PATH) and reloads on session start.
  • Default: 80% of the context window.
  • Leave headroom above Pi's keepRecentTokens (default 20000, configurable globally in ~/.pi/agent/settings.json, per project in <cwd>/.pi/settings.json, and per model via compaction.modelOverrides): a threshold at or below it makes the handoff refire right after each compaction. /tidy-threshold rejects such values with an error and does not save them.

Development

See CONTRIBUTING.md for the dev setup (bun install, bun test, tsc --noEmit), branch model, and release flow. User-facing changes go in CHANGELOG.md under [Unreleased].