ExAthena.Tools.Read (ExAthena v0.17.0)

Copy Markdown View Source

Reads a file from the filesystem.

Arguments:

  • path (required) — absolute path or a path relative to ctx.cwd.
  • offset (optional) — line number to start reading from (1-indexed).
  • limit (optional) — maximum number of lines to return.

Result is the file contents with lines prefixed by <lineno>\t so the model can reference specific lines the way Claude Code does.

Oversized output never floods the context: a whole-file read of a large structured file returns a line-ranged OUTLINE ("lines 12–80: def foo") the model can drill into via offset/limit; unstructured files and huge explicit windows are head-capped with an explicit marker.