delete_file
Delete a file or directory. On macOS, items move to Trash for recovery; use permanent=true to bypass. Restricted to home directory for safety.
Instructions
Delete a file or directory. On macOS, moves to Trash by default (recoverable); pass permanent=true to permanently delete. Safety: only allows deletion within the home directory. Requires allow_file_write in ~/.syscontrol/config.json.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "delete_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Path to the file or directory to remove. | |
| permanent | No | Permanently delete instead of moving to Trash (default false). |