2 genuinely different descriptions of this tool
Plain text · sha256 c5d31bd00109
The description, line by line
3 lines Line numbers are v2.1.269 on the left and this capture on the right.
1
Writes a file to the local filesystem.
1
Writes a file to the local filesystem, overwriting if one exists.
2
2
3
Usage:
4
- This tool will overwrite the existing file if there is one at the provided path.
5
- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
6
- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
7
- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
8
- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.
3
When to use: creating a new file, or fully replacing one you've already Read. Overwriting an existing file you haven't Read will fail. For partial changes, use Edit instead.
What it accepts
2 parameters The JSON parameter schema sent beside this description, 408 characters of it. Name, type, then whether the client marked it required.content
string
required
The content to write to the file
file_path
string
required
The absolute path to the file to write (must be absolute, not relative)
sha256 7369ad28cd66 · the schema as the client sent it:
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"content": {
"description": "The content to write to the file",
"type": "string"
},
"file_path": {
"description": "The absolute path to the file to write (must be absolute, not relative)",
"type": "string"
}
},
"required": [
"file_path",
"content"
],
"type": "object"
}