# `Alloy.Tool.Core.Read`
[🔗](https://github.com/alloy-ex/alloy/blob/v0.10.1/lib/alloy/tool/core/read.ex#L1)

Built-in tool: read files with line numbers.

Returns file contents formatted as `line_number\tcontent` (matching
`cat -n` output). Supports pagination via `:offset` and `:limit`
parameters, defaulting to the first 2,000 lines.

## Usage

    config = %{tools: [Alloy.Tool.Core.Read], ...}

The agent can then call:

    %{file_path: "lib/app.ex", offset: 10, limit: 50}

---

*Consult [api-reference.md](api-reference.md) for complete listing*