# TwinSweep

> Find exact duplicate files and near-duplicate photos on your Mac, then move the extras to the Trash with one-click undo. Fast and light on memory. Pay once. Works with Claude, ChatGPT and Shortcuts. Native macOS app (14+), one-time purchase $19, 7-day free trial. All processing is local.

AI assistants can control TwinSweep through a local MCP server (stdio), Apple Shortcuts / App Intents, or a CLI.

## Connect
- MCP command: `/Applications/TwinSweep.app/Contents/MacOS/twinsweep mcp`
- In the app: Settings → AI → Connect (Claude Desktop, Cursor) or Copy Command (Claude Code)

## Tools
- `find_duplicates`: Scan folders for duplicate files (identical content) and optionally near-duplicate photos (resized / re-saved / slightly different). Changes nothing. Returns a scan_id, the space that could be freed, and each group with the copy to keep. Skips app bundles, photo libraries, hidden files, symlinks and iCloud files not downloaded.
- `get_scan`: Show all groups of a previous scan ("latest" or a scan_id). Read-only.
- `trash_duplicates`: Move the extra copies from a scan to the Trash, keeping one copy per group. Each file is re-checked first (still there, unchanged); changed files are skipped. Reversible with undo_last until the Trash is emptied. Ask the user before calling.
- `undo_last`: Put back the files from the most recent trash_duplicates (from the Trash to their original folders). Never overwrites a file that now exists at the original path.

## Example requests
- Clean up duplicate files in my Downloads folder
- How many GB of duplicate photos are in my Pictures folder?
- Keep the sharpest copy and remove the rest in this folder
- Find duplicate videos larger than 1 GB
- Undo the last clean-up

## Links
- [Home](https://tidyware.app/twinsweep/)
- [For AI agents](https://tidyware.app/twinsweep/for-ai-agents.html)
- [Privacy](https://tidyware.app/twinsweep/privacy.html)
- [Download](https://tidyware.app/twinsweep/#pricing)