read_project_artifacts
Read project artifact files in batch, supporting full content, specific sections, or line ranges with truncation and line numbers.
Instructions
[ARTIFACT TOOLS] Reads one or more artifact files in a single batch call.
Each item in reads targets one file and specifies an independent read mode.
Read modes per item: full — returns the entire file content (default). section — returns only the content under a named ## header (requires section_name). lines — returns a specific line range (requires start_line and end_line).
Optional per-item fields: max_chars : int — truncate response at N characters (default 10000). skip_chars : int — skip N characters from the start of the selection. direction : 'begin' | 'end' — read from start or end of file (default 'begin'). line_numbers : bool — prefix each line with its 1-based line number.
Do NOT loop this tool per file — batch all reads into a single call to minimise round-trips. For source code files in src/, use view_file_source instead.
Returns: list of result objects — each with path and content (or error if not found). Raises: per-item error entry if a path does not exist; does not abort the batch.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reads | Yes | List of read requests | |
| project | Yes | Project name |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |