Desktop: Filesystem
desktop_filesystemPerform file system operations—read, write, copy, move, delete, list, search, or inspect files and directories—using absolute paths for local automation.
Instructions
Manage file system operations with eight modes: 'read' (read text file contents with optional 1-based line offset/limit), 'write' (create or overwrite a file; set append=true to append), 'copy' (copy file or directory to destination), 'move' (move or rename file/directory), 'delete' (delete file or directory; set recursive=true for non-empty dirs), 'list' (list directory contents with optional glob pattern filter), 'search' (find files matching a glob pattern under a root directory), 'info' (get file/directory metadata: size, dates, type). Use absolute paths. Relative paths are NOT supported.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | Operation mode. | |
| path | Yes | Absolute path to the file or directory to operate on. | |
| limit | No | Maximum number of lines to return (read mode). | |
| append | No | Append to file instead of overwriting (write mode). | |
| offset | No | 1-based starting line number for read mode. | |
| content | No | Text content to write (required for write mode). | |
| pattern | No | Glob pattern to filter (required for search; optional for list). | |
| encoding | No | Text encoding for read/write operations. | utf-8 |
| overwrite | No | Allow overwriting existing destination (copy, move). | |
| recursive | No | Recurse into sub-directories (list, search, delete). | |
| destination | No | Destination path (required for copy and move modes). | |
| show_hidden | No | Include hidden files/dirs starting with '.' (list mode). |