Move path
move_pathMove or rename files or directories in a workspace, optionally overwriting a target file and creating missing parent directories. Use it to relocate paths without copying or deleting them.
Instructions
Move or rename a file or directory inside the workspace. overwrite=true replaces an existing file, never a directory; create_dirs (default true) makes missing parents of to.
Use when: you rename or relocate files or folders. Not undoable: take a snapshot first when they are not in git.
Avoid when: you duplicate (copy_path) or remove (delete_path).
Output: from, to, kind, overwritten, entries, bytes. Missing source gives not_found, an existing target without overwrite gives conflict.
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": {
"from": "<from>",
"to": "<to>"
},
"name": "move_path"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | New workspace path: the final name, not a parent directory. | |
| from | Yes | Existing workspace path to move or rename. | |
| reason | No | Optional why (max 400 chars), audit-logged. | |
| overwrite | No | true replaces an existing target file (default false). A directory is never replaced. | |
| create_dirs | No | true creates missing parent directories of `to` (default true). |