big-gulp-reads
Override pi's built-in read tool with a larger, configurable truncation limit
Package details
Install big-gulp-reads from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:big-gulp-reads- Package
big-gulp-reads- Version
1.0.2- Published
- Nov 14, 2026
- Downloads
- not available
- Author
- taylorsatula
- License
- MIT
- Types
- extension
- Size
- 12 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./extensions/big-read.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
big-gulp-reads
A pi package that replaces the built-in read tool with one whose truncation limit you control. The built-in caps file reads at 50KB / 2000 lines with constants no setting can change; big-gulp-reads raises that to 200KB / 5000 lines by default and lets you change it at any time without restarting.
Install
pi install npm:big-gulp-readsNew sessions pick it up automatically — the extension registers a tool named read that replaces the built-in. The offset/limit parameters, continuation notices, and image attachments all work exactly as before.
Usage
| Command | Effect |
|---|---|
/big-gulp-reads |
Show current limits |
/big-gulp-reads 400 |
Set the byte cap to 400KB |
/big-gulp-reads lines 10000 |
Set the line cap to 10000 |
/big-gulp-reads reset |
Back to defaults (200KB / 5000 lines) |
Limits persist across sessions in ~/.pi/agent/big-gulp-reads.json and apply to the current session immediately.
Caveats
- Watch your context window. A full 131k-token context is only ~650KB of prose, so a couple of unbounded reads can consume it — pick a limit that fits your model.
- Images are not auto-resized. pi does not export its image-resize helper, so image reads are sent as attachments at full size; providers with image dimension caps may reject very large images.