create_file
Creates a file inside a folder. Not on the root.
Refuses protected paths and root files.
- Tool name
- create_file
- Group
- Files
- Risk
- low
- Needs approval
- never
- Approval rule
- No approval. Hard blocks apply.
- Allowed in scheduled jobs
- No
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| path | string | Yes | Path relative to the project, such as vault/note.md. | ||
| content | string | No | The text to store or write. | Memory notes are read back into prompts in slices of 4,000 characters (global) or 1,500 (session). |
Returns
A confirmation.
Example (made up for this page)
{
"path": "demo"
}Created vault/notes/a.mdSide effects
- Writes a file.
How it can fail
| When | What the agent sees |
|---|---|
| Root file | Refused: root files cannot be edited by the agent. |
| Protected path | HARD BLOCK: harness core cannot be written |
See also:Files tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.