pi-posthorse
Posthorse: fresh context, same journey. No-summary context rollover for the Pi coding agent (official Pi 1.0+ or the fitchmultz/pi fork), with durable notes and
What is pi-posthorse?
Posthorse: fresh context, same journey. No-summary context rollover for the Pi coding agent (official Pi 1.0+ or the fitchmultz/pi fork), with durable notes and history recovery.
Overview of pi-posthorse
What it is
Posthorse is an extension for the Pi coding agent (official Pi 1.0+ or the fitchmultz/pi fork) that manages context window rollover without using an automatic model-generated summary. It adds explicit notes and history retrieval, along with a handoff or bounded recovery record, instead of the default summary-based approach.
Key features
- No-summary context rollover using a bounded recovery record and safe recent-message tail, avoiding automatic summarization.
- Tools for the model:
new_context(clean reset),get_context_remaining(estimate tokens until rollover),notes(list, read, search, write, append task notes), andhistory(search and read earlier conversation including images). - Automatic rollover respects Pi's compaction settings, requiring at least 10,000 tokens after the reserve for automatic Posthorse rollover.
- Notes are stored as plaintext files under
.pi/notes/or.pi/package-notes/, with no network requests made by Posthorse. - Supports both official Pi 1.0+ and the fitchmultz/pi fork.
Use cases
Using Posthorse is suitable for long Pi tasks where you want fresh context windows without a model-generated summary. It can nudge the model to update task notes before rollover, then continue working. The new_context tool allows deliberate clean resets, and the history tool enables searching and reading previous conversation entries, including images.
Getting started
Use Node 24.12.0 or later and Pi 1.3.0 or later. Run these commands:bashpi install npm:pi-posthorsepiRestart Pi after installation. To try Posthorse for one session, run pi -e npm:pi-posthorse. For more details, see the repository README.
License and pricing
The license is MIT. Pricing type is open source.
Based on the project's public README and repository metadata.