Help & getting started

macOS permissions

AI Agent Clean needs specific permissions to scan Library folders and external volumes. macOS prompts on first use; you can also grant them manually:

1. Full Disk Access — System Settings → Privacy & Security → Full Disk Access → enable AI Agent Clean. Required for scanning most of ~/Library and system caches.
2. Files and Folders — grant access when prompted for Desktop, Documents, and Downloads if those modules are enabled.
3. Removable Volumes — for Space Lens on external drives, allow volume access when asked.

Without Full Disk Access, scans may show incomplete results. The app indicates which modules need additional permission.

Recovering files from Trash

By default, AI Agent Clean moves deleted items to Trash — not permanent erase. If you removed something by mistake:

• Open Trash — click the Trash icon in the Dock.
• Find the item — sort by Date Added to locate recent cleanup.
• Put Back — right-click the file or folder and choose Put Back.
• Empty Trash caution — once Trash is emptied, recovery requires backup or third-party tools.

Safety reminders

• Preview first — expand scan groups and uncheck uncertain items.
• Protected paths — system-critical locations cannot be removed.
• Regenerable caches — AI and browser caches rebuild automatically.
• Backups — Time Machine or cloud backup is always recommended before bulk cleanup.

Frequently asked questions