Files & Recovery
Search everywhere, reveal in Finder, undelete, and shred securely.
5 tools — 3 read-only, 2 that always ask your approval first.
Read-only tools never modify anything; anything that changes your Mac pauses on an Approve card first.
find_files Read-onlyActually search the user's Mac for files by name and return the matching file paths (runs a fast Spotlight search). This is different from open_feature, which only opens the Advanced Search panel without searching.
reveal_in_finder Read-onlyReveal a file or folder in Finder — opens a Finder window with the item selected/highlighted so the user can see exactly where it is. This does not open, launch, move, or modify the file — it only shows it in Finder. Give an absolute path you actually have (for example one of the paths find_files returned).
recover_deleted_files Read-onlyRead-only scan of Time Machine local snapshots for recently deleted files that could be recovered (reports counts; restoring is done in the File Recovery panel).
delete_files_securely Asks firstSecurely delete specific file(s) the user names — overwrites the data so it can't be recovered, then removes the file. Files must be inside the user's home folder.
restore_trash_item Asks firstRestore one item from the Trash back onto the Desktop — the undo of trashing a file, and the safe complement to empty_trash. macOS does not record a file's original folder for programmatic put-back, so it is restored to the Desktop.