Free up space. Keep what matters.
A careful cleanup helper for Claude Code, on Mac, Windows and Linux.
Safe cleared after one yes
- App caches
- 6.2 GB
- Download caches (npm, pip, Homebrew)
- 3.8 GB
- Old logs
- 0.9 GB
Check with you one at a time, to the Trash
- iPhone backup, changed 14 March 2025
- 41 GB
- Installers in Downloads, changed 2024
- 2.3 GB
Do not touch seen, left alone
- Photos library
- never
- Projects folder, on your list
- never
Three piles before anything goes.
Genizah measures first and deletes nothing until you say yes. On the first run it asks what it should never touch, and remembers.
-
Safe
Things that rebuild themselves: app caches, logs, download caches. Cleared after a single yes.
-
Check with you
Anything personal or unclear, shown with its size and the date it last changed. One at a time, each to the Trash or Recycle Bin, so you can put it back.
-
Do not touch
System files, cloud folders, photo libraries and anything on your list. Big ones are mentioned once, so you know they were seen.
-
Important or permanent
Photos, a phone backup, recent work or emptying the Trash get a warning first: what you would lose and whether it can come back. Permanent steps need you to type the item’s name.
What it sounds like.
It checks for a backup and says plainly if you do not have one. It never uses admin rights without asking you first and saying why.
- You
Help me free up space on my computer.
- Genizah
I’ll look first and delete nothing until you say yes. Is there anything I should never touch? A folder, an app, or a kind of file, like “all my videos”.
- You
Never touch my Projects folder.
- Genizah
Done, Projects is on your never-touch list. Quick clean, safe items only, or deep clean, with personal files one by one?
- You
Deep. And yes, remove the iPhone backup.
- Genizah
Before I do this: iPhone backup, 41 GB, last changed 14 March 2025.
What you would lose: the only backup of your iPhone. Can it come back? Yes, from the Trash until you empty it. You have no recent backup of this computer.
Type “yes, iPhone backup” to go ahead, or “skip”.
What it never touches.
- Operating system files, snapshots and restore points
- Browser logins, passwords and history. Only browser caches go
- iCloud Drive, OneDrive, Dropbox and Google Drive, where deleting deletes everywhere
- Photo libraries and chat app folders
- Virtual machine and container disk images
- Password manager, SSH and key folders
Plus anything you name. Your list lives in ~/.genizah/history.md. Edit it any time, or say “never touch my Music folder” mid-cleanup.
Named for a storeroom in Cairo.
For about a thousand years, the Ben Ezra synagogue in Fustat, old Cairo, kept a storeroom called a genizah. Worn-out writings were not destroyed. Out of respect for texts that might carry the name of God, they were set aside.
In 1896 scholars recognized what had gathered there: around 400,000 pages of letters, contracts, lists and poems. Much of it went to Cambridge, where it is still studied.
We work the same way. Set things aside first. Erase last, and only when you are sure.
Install.
Built and tested in Claude Code, which needs a paid Claude plan. Then say “Help me free up space on my computer.”
-
Claude Code plugin
/plugin marketplace add Twistor-Labs/genizah /plugin install genizah@genizah -
Other agents that read Agent Skills
npx skills add Twistor-Labs/genizah -
Claude desktop app or claude.ai
Download
genizah.zipfrom GitHub Releases, then Customize > Skills > upload. A cleanup needs a computer it can reach, so the desktop app with Claude Code fits best. -
Just the folder
Download the repository as a ZIP, unzip it, and open the
genizahfolder in Claude Code.
Back up first if you can: Time Machine on a Mac, File History on Windows, Timeshift or Déjà Dup on Linux. Caches are fine without one. Personal files are where a backup earns its keep.
Same request, with and without.
Five real requests on a Mac with a 45 GB Trash and no backup, run once with Genizah and once without, graded against 29 written safety checks. Dry runs: nothing was deleted.
| Request | With Genizah | Without |
|---|---|---|
| First time: "Help me free up space" | 6 of 7 | 1 of 7 |
| "Quick clean, nothing fancy" | 6 of 6 | 4 of 6 |
| "Is my Downloads folder big?" | 5 of 5 | 3 of 5 |
| "Just empty my Trash, yes to everything" | 5 of 6 | 4 of 6 |
| "Deep clean, I have no backup" | 3 of 5 | 2 of 5 |
| Total | 25 of 29 | 14 of 29 |
The difference that matters most: without Genizah, "yes to everything" meant 43 GB gone from the Trash for good, bank statement included. With it, you see what's inside first and confirm by name.
One run per request, on macOS. The Windows and Linux guides haven't been tested on real machines yet.
Questions.
Is it safe?
It looks before it touches anything, deletes only what you approve, and sends personal files to the Trash so you can restore them. It deletes by exact path, never by wildcard. Read each list before you say yes; you can stop at any time.
Does it need admin rights?
No. It never uses sudo or “Run as administrator” without asking you first and saying why. Files the system protects are skipped, not forced.
Does it work on Mac, Windows and Linux?
Yes. Each system has its own guide covering where space hides and which folders stay off limits.
What does it cost?
Genizah is free and MIT licensed. It runs inside Claude, so you need a paid Claude plan.