Tool · pi · badlogic

read

pi/readRead · primarysourcechecked 2026-09-02
What matters here1 of 3 invariants hold · 1 fails · 1 unverified

The facts the registry marks decision-changing, with how the other implementations answered. An invariant may be shown as pass/fail; a design choice never is, however unusual it looks.

How this differs from most implementations

Derived by comparing every recorded value against the other implementations of the same capability. Differing is not a defect unless the row is marked an invariant.

Description, as the model sees it

Not recorded yet — the verbatim description has not been captured for this tool.

Registered schema

Not recorded yet — the schema as registered has not been captured for this tool.

Observed · Read

compare all →
FactThis toolAcross all implementations
Output shape3 of 3 recorded
Dedicated read toolreadsrc
Line numberingnonesrclike 2 of 7N + TAB ×2 · N: ×2 +12 unverified
Output wrapperplainsrclike 6 of 9<path>/<type>/<content> ×2 · raw stdout ×1
Limits3 of 4 recorded
Default line cap2000srclike 6 of 81000 ×1 · none ×11 unverified
Byte / char cap50 KBsrclike 3 of 6100 KB ×1 · 100k chars (not lines) ×1 +12 unverified
Per-line cap—5 others recorded2000 chars ×4 · none ×12 unverified
Whichever hits firstlines or bytessrclike 4 of 6chars ×1 · lines ×12 unverified
Pagination4 of 5 recorded
Offset base1-indexedsrclike 7 of 80-indexed ×1
Announces truncationinvariantholdssrc
[Showing X-Y of N. Use offset=Z]
all 7 hold1 unverified
Continuation hint[Showing X-Y of N. Use offset=Z]srconly one of 7(Showing X-Y of N. Use offset=Z) ×2 · (truncated) ×1 +31 unverified
Reports total linesyessrclike 2 of 4linesShown[] ×1 · yes (End of file - total N) ×14 unverified
Out-of-range offset?2 others recordedexplicit error w/ line count ×26 unverified
Non-text2 of 6 recorded
Binary content never enters context silentlyinvariant?4 of 5 holdtrue ×4 · false ×14 unverified
Binary files?5 others recordederror: Cannot read binary file ×2 · raw bytes into context ×1 +24 unverified
Imagesattachment, auto-resize 2000²srconly one of 9attachment (jpeg/png/gif/webp) ×1 · attachment + mime sniff ×1 +6
PDFs?5 others recordedattachment ×2 · page ranges + continuation ×1 +23 unverified
Notebooks?2 others recorded(notebook-edit tool) ×1 · cells + outputs ×16 unverified
Giant single linepoints at bash sed fallbacksrconly one of 7per-line cap ×4 · char budget absorbs it ×1 +12 unverified
Errors1 of 4 recorded
Missing path?4 others recordedDid you mean one of these? ×2 · error ×1 +15 unverified
Path is a directory?4 others recordedlists entries ×2 · error ×1 +15 unverified
Empty file?2 others recordedempty stdout ×1 · explicit reminder ×17 unverified
Non-vision modelexplicit note in outputsrconly one of 2requires image-capable model ×15 unverified
Correctness1 of 3 recorded
Mixed line endings?2 others recordedraw ×1 · renders CR visibly ×17 unverified
Staleness check before writeinvariantfailssrc3 of 9 holdtrue ×3
Line-number contamination guard—
n/a (no numbers)
2 others recordedinstructs model to strip prefix ×1 · write-side detector rejects N| content ×1
Side effects1 of 1 recorded
Injects nearby instruction filescompact AGENTS.md/CLAUDE.mdsrconly one of 3AGENTS.md as system-reminder ×2

Other tools in pi

names verbatim, as registered