@caveman-ai/pi

Native Caveman extension for the Pi coding agent — proxy routing, exact-recovery caveman_retrieve tool, native lifecycle events, Core injection, and tool-output shrinking.

Packages

Package details

extension

Install @caveman-ai/pi from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@caveman-ai/pi
Package
@caveman-ai/pi
Version
0.1.0
Published
Aug 20, 2026
Downloads
209/mo · 43/wk
Author
juliusbrussee
License
MIT
Types
extension
Size
49.8 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.mjs"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@caveman-ai/pi

Native Caveman extension for the Pi coding agent.

One extension, four jobs:

  • Proxy routing — points the selected model's provider at your local Caveman proxy (/w/pi/...) with a baseUrl-only override. Pi keeps owning auth, model names, pricing, and models.json; nothing is copied or rewritten.
  • Exact recovery — registers a single model-visible tool, caveman_retrieve, backed by the local caveman-mcp binary and the shared CCR store. Compressed bytes are always recoverable, byte-exact.
  • Native lifecycle — bridges Pi session/turn/tool events into the Caveman native runtime (Core injection, per-turn context, tool-output shrinking).
  • Honest fallback — routing activates only after the recovery gate holds (proxy alive, recovery contract matched, MCP child initialized). Anything else is a visible pass-through: direct provider, one notice, no savings claims. OAuth/subscription-authenticated models are never routed.

Install

Through the Caveman CLI (recommended — journaled, reversible):

caveman wrap pi      # this session only
caveman enable pi    # persistent; plain `pi` stays routed until `caveman disable pi`

Or as a plain Pi package:

pi install npm:@caveman-ai/pi

Requires the Caveman CLI (npm i -g @caveman-ai/cli) plus the local caveman-proxy / caveman-mcp binaries (caveman setup). Without them the extension loads, says so once, and stays out of the way.

Pinned against @earendil-works/pi-coding-agent 0.84.2.