packages / pi-readcache
extension Tool providers

pi-readcache

๐Ÿง  Pi extension that optimizes read tool calls with replay-aware caching and compaction-safe trust reconstruction

No reviews yet

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

observed

Loaded 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.

โ–ฒ Review before you install. pi packages run with your full system permissions. Check the source, pin versions, and prefer authors you trust.

Reviews

0 published

Sign in with GitHub to write a review, reply, or vote.

No reviews yet โ€” be the first.

More in Tool providers

  • @juicesharp/rpiv-web-tools โ€” Pi extension. Web search and fetch for the model with pluggable providers (Brave, Tavily, โ€ฆ
  • pi-web โ€” Web UI for pi that keeps sessions alive in real workspaces โ€” run and monitor pi from the bโ€ฆ
  • @vaayne/pi-web-tools โ€” Pi extension for web fetching and search capabilities
  • @firstpick/pi-utils โ€” Shared utilities for Firstpick Pi extension packages.