pi-readcache
π§ Pi extension that optimizes read tool calls with replay-aware caching and compaction-safe trust reconstruction
Install
pi install npm:pi-readcache
Installs from npm into ~/.pi/agent/.
Add -l for project-local (.pi/). Manage with pi list / pi update / pi remove.
What this package can reach
Detected automatically from the source at
version 0.2.0.
This describes access, not safety β you decide whether it's appropriate for what
the package claims to do.
- Behavior β Changes how the agent thinks Modifies the system prompt, injects messages, or rewrites conversation context.
- Files β Reads files outside your project Touches paths beyond the working directory, such as your home folder.
- New tools β Adds model-callable tools Gives the agent new abilities. Additive and visible, unlike an override.
- UI β Draws its own interface Renders widgets, footers, dialogs or full-screen views.
What it actually did when run
observedLoaded in a sandbox with no network, a read-only filesystem and a recording stand-in for pi's API. This is what it called β not what the source suggests it might.
Replaces pi's built-in tool: read.
Every use of that tool goes through this
package instead of pi.
Tools registered readreadcache_refresh
Events subscribed session_compactsession_forksession_shutdownsession_startsession_switchsession_tree
APIs called appendEntryregisterCommandregisterToolsendMessagesessionManager.getBranchsessionManager.getEntriessessionManager.getEntries.somesessionManager.getLeafIdsessionManager.getSessionIdui.notify
5 calls the source scan did not predict
sessionManager.getBranch Β· sessionManager.getEntries Β· sessionManager.getEntries.some Β· sessionManager.getLeafId Β· sessionManager.getSessionId
Reached through a value the scan could not follow β passed as an argument, stored on another object, or returned by a helper.
Run against version 0.2.0 on 2026-08-02.
Registration-time behaviour under default settings; other configurations may differ.
Reviews
0 publishedSign in with GitHub to write a review, reply, or vote.
No reviews yet β be the first.
More in Tool providers
- lumen-pi-extension β Pi extension that opens lumen on the diff after each agent turn and feeds annotations backβ¦
- pi-autocontext β autocontext extension for Pi coding agent β iterative strategy generation, LLM judging, anβ¦
- @open-pets/pi β @open-pets/pi
- @juicesharp/rpiv-web-tools β Pi extension. Web search and fetch for the model with pluggable providers (Brave, Tavily, β¦