ck_fs_read
Read-onlyIdempotent
Read a file from the project root by its relative path. Supports full file reads or windowed reads by specifying start line and max lines.
Instructions
Read a file from the bound project root. Read-only — no files are modified or created. path is required and must be relative to the project root (e.g., lib/my_module.ex). start_line (1-indexed) and max_lines enable windowed reads for large files. Omit both to read the entire file. Use ck_fs_read to inspect a file at a known path. Use ck_fs_find to locate a file by name fragment. Use ck_fs_grep to search inside files by content pattern. Use ck_fs_ls to list directory contents.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_lines | No | ||
| path | Yes | File or directory path relative to the project root. | |
| project_root | No | Absolute path to the project root directory on the local filesystem. | |
| session_id | No | Unique session identifier for correlating findings, proofs, budget, and audit trail. | |
| start_line | No | 1-indexed starting line number for partial file reads. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | No | ||
| path | No | ||
| start_line | No | ||
| total_lines | No |