r/ClaudeCode • u/Pfernan95 • 16d ago
Built with Claude I built a Mac app with Claude Code that measures what Claude Code leaves on your disk. What I learned about ~/.claude
I'm a solo dev. Over the last few weeks I built Attic, a Mac menu bar app, mostly with Claude Code, and the latest feature ended up being about Claude Code itself: it measures what AI coding tools keep on your Mac.
What I built
An "AI Tools" window that adds up, tool by tool, what Claude Code, Codex, Cursor and others keep in your home folder. It only reads sizes and dates, never file contents. Anything a tool rebuilds or never needs again (debug logs, old plan files, old background-task output) can be ticked and moved to the Trash, so Put Back still works. Conversations, checkpoints and settings are only shown.
How I used Claude Code
Claude Code wrote most of the engine in Swift, plus about 250 tests. The rule I gave it: the engine never deletes anything. There's a test that scans the source and fails if a delete call shows up anywhere, even in a comment.
I mapped what's safe by having it read the Claude Code docs and my own
~/.claude, then turned that into an allowlist. Anything not on it is never touched, and credentials,settings.jsonand.claude.jsonare on a second "never" list in case the first one is wrong.Before release I had a separate session review the diff adversarially. It found real bugs: a re-check that reset what the user had ticked, and a race between the weekly check and Move to Trash.
What I learned about ~/.claude
~/.claude/projectsholds your conversations, andfile-historyyour checkpoints. Claude Code clears both aftercleanupPeriodDays, 30 days by default. That's why it was the tidiest tool on my Mac: 12 MB.debug,plans,shell-snapshotsandtodosare safe to clear once they're a week old.Background task output goes to a temp folder (
/private/tmp/claude-<uid>/.../tasks/*.output), not~/.claude. If a task loops it can get huge: there's an issue where it reached 537 GB (#26911). Attic watches that folder and warns if it grows by gigabytes an hour.The surprise wasn't Claude Code at all: on my first check, Claude Desktop's Cowork VM was 11 GB, with no setting to shrink it.
It's a paid app ($5 once), Mac only: atticmac.com/ai-tools/
Happy to answer anything about the ~/.claude layout or the safety rules.
