Files
oh-my-pi/packages/coding-agent/src/prompts/tools/read.md
T
can1357 6a9e6c0ce9 feat: don't prefix protocol results, enforce full read for skill
- Simplified TruncationResult interface by making maxLines, maxBytes, and other derived fields optional, reducing redundancy.
- Refactored noTruncResult helper to auto-compute totalLines and totalBytes, eliminating repetitive parameter passing.
- Removed truncatedBy null checks and conditional formatting logic in truncation notice functions for cleaner output.
- Consolidated internal URL handling to use noTruncResult and removed unused displayMode variable.
- Clarified documentation in read.md to distinguish filesystem output from text output formatting.
2026-03-13 15:05:11 +01:00

1.1 KiB

Reads files from local filesystem or internal URLs.

- Reads up to {{DEFAULT_LIMIT}} lines default - Use `offset` and `limit` for large files; max {{DEFAULT_MAX_LINES}} lines per call {{#if IS_HASHLINE_MODE}} - Filesystem output is CID prefixed: `LINE#ID:content` {{else}} {{#if IS_LINE_NUMBER_MODE}} - Filesystem output is line-number-prefixed {{/if}} {{/if}} - Supports images (PNG, JPG) and PDFs - For directories, returns formatted listing with modification times - Parallelize reads when exploring related files - Returns file content as text; images return visual content; PDFs return extracted text - Missing files: returns closest filename matches for correction - You **MUST** use `read` instead of bash for ALL file reading: `cat`, `head`, `tail`, `less`, `more` are FORBIDDEN. - You **MUST** use `read(path="dir/")` instead of `ls dir/` for directory listings. - You **MUST** always include the `path` parameter — NEVER call `read` with empty arguments `{}`. - When reading specific line ranges, use `offset` and `limit`: `read(path="file", offset=50, limit=100)` not `cat -n file | sed`.