القائمة
Reads the UTF-8 text content of multiple files in a single concurrent operation, returning a mapping of paths to their content or error status.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | read_files_batch |
| version | 1.0.0 |
| author | clawthority |
| license | MIT-0 |
| description | Reads the UTF-8 text content of multiple files in a single concurrent operation, returning a mapping of paths to their content or error status. |
| read_when | user asks to read multiple files at once, batch read files, read several files, read a list of files |
| action_class | filesystem.read |
You are the read_files_batch tool for Clawthority. You read multiple files concurrently in a single operation and return each file's content or a typed error result, keyed by the original path.
Promise.allSettled.results object mapping each requested path to either a success or error entry.Invoke this tool when the user or agent wants to:
read_file calls for a known list of paths| Name | Type | Required | Description |
|---|---|---|---|
paths | string[] | Yes | List of file paths to read. |
| Name | Type | Description |
|---|---|---|
results | object | Mapping of each requested path to its per-file result (see below). |
Success:
{ "status": "ok", "content": "<utf-8 string>" }
Failure:
{ "status": "error", "code": "not-found | not-a-file | fs-error", "message": "<description>" }
{
"tool": "read_files_batch",
"params": {
"paths": [
"/project/src/index.ts",
"/project/src/utils.ts"
]
}
}
{
"results": {
"/project/src/index.ts": {
"status": "ok",
"content": "import { foo } from './foo.js';\n\nfoo();\n"
},
"/project/src/utils.ts": {
"status": "error",
"code": "not-found",
"message": "File not found: /project/src/utils.ts"
}
}
}
| Error Code | Cause |
|---|---|
not-found | The specified path does not exist. |
not-a-file | The specified path exists but is a directory, not a file. |
fs-error | An unexpected filesystem error occurred while reading the file. |
Errors are returned per-file in the results map — the tool itself never throws.
This tool is classified as filesystem.read — a read-only operation that does not modify the filesystem. It is not subject to HITL gating.
Checks whether a given path exists in the filesystem, returning a boolean result for both files and directories.
Copies a file from a source path to a destination path. The source file remains unchanged after the operation.
Removes a file or empty directory at the specified path. Recursive deletion and trash/recycle-bin moves are out of scope.
Replaces the first occurrence of old_string with new_string in a file.
Searches a directory tree recursively for files whose relative path matches a glob pattern, returning an array of absolute file paths.
Stages specified file paths or glob patterns for commit in a git repository.