pi-read-full

A Pi extension that lets the agent read a complete text file in one call.

Standard read tools can clip long files or long lines. The agent then needs several calls to read the whole document. read_full returns the full text without clipping, line numbers, or hashline markup. It works alongside your existing read tool rather than replacing it.

Install

pi install npm:@jetserge/pi-read-full

Reload or restart Pi after installation. No configuration is needed.

Use

Ask Pi to read a file in full, or continue a task whose instructions require a complete document. The extension tells the agent when to choose read_full. You can also request it by name:

Use read_full to read the entire specification before reviewing this change.

The terminal shows a compact human-readable size, line count, and approximate token count. Expand the result to view the text. Terminal escape sequences are displayed literally, not executed. The agent receives the original full text when the context-fit safeguard accepts it.

Limits

• Text files only: valid UTF-8 without NUL bytes. Use read for images.
• No fixed file-size or line limit. Before returning text, read_full estimates its context cost with Pi's characters / 4 heuristic. It refuses a read that exceeds the current model's remaining context after Pi's default response reserve. If current usage is unknown, it checks against the model's full window minus that reserve.
• No edit anchors. The agent still needs an ordinary read or anchored search before a hashline edit.
• Hosts with tool-specific permission rules or allowlists must configure read_full separately.

Requires Node.js 22.18 or newer. Tested against Pi 0.85.1. This extension is an independent implementation, not a fork of pi-read.

For development guidance, see AGENTS.md. For npm publishing, see RELEASING.md.