1. Docs
2. /
3. Tool reference
4. /
5. Files & Drive

Files & Drive

Workspace files and folders, plus the searchable index of attached drives.

14 verbs in this family.

• createFolder write Create a folder to organize Files.
• deleteFile writedestructive Delete a File permanently.
• deleteFolder writedestructive Delete a folder and everything inside it.
• gatherFiles read Plan a gather across drives: given indexed files, group them by drive and report which drives are plugged in vs.
• getFileContext read Get the full lightweight context for one indexed drive file: metadata plus extracted text / transcript, and whether its drive is plugged in right now.
• indexDrive writeexternal Index a connected drive on one of the user's machines: the MachineSync daemon scans it on-device in tiers (metadata → light → deep) and pushes a lightweight per-file index up, so the drive stays…
• listFiles read List folders, Files, and private voice notes.
• moveFile write Move a File into a different folder, or file it into a Space.
• moveFolderToSpace write File a folder: and everything inside it: into a Space, so the whole tree lives with that project instead of floating unbound.
• readFile read Read what is INSIDE a Cloud File: a CSV/TXT/MD/DOCX document, a PDF's text layer, an audio or video transcript, or an IMAGE (a vision description of what it shows plus any legible text, in…
• renameFile write Rename a File.
• renameFolder write Rename a folder.
• searchFiles read Search everything the user has: their Cloud Files (by filename AND by the text inside them), their private voice notes, and their local drive index: in one call.
• shareFolder writeconsent Request sharing a folder with a Space.