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), and history (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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/fitchmultzpi-posthorse.svg)](https://yunodb.com/tools/fitchmultzpi-posthorse?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/fitchmultzpi-posthorse?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/fitchmultzpi-posthorse.svg" alt="Featured on YunoDB" height="20"></a>