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.

5 shown

find_files Read-only

Actually 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-only

Reveal 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-only

Read-only check of the Time Machine local snapshots a recently deleted file could be recovered from — how many there are and the dates they cover. It lists them without opening them, so it cannot say whether a given file is recoverable; browsing and restoring are done in the File Recovery panel.

delete_files_securely Asks first

Securely delete specific file(s) the user names — overwrites the file's data, then removes the file. Best-effort, not a guarantee: on an SSD or APFS volume an overwrite may not reach every earlier copy, and snapshots, backups, synced copies and SSD spare blocks are outside it. FileVault only protects data written while it was on. Files must be inside the user's home folder.

restore_trash_item Asks first

Restore 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.