AI Skill MartBrowse skillsPromptsProgramsLearnWhat is a Skill?
 
← Back to list

Claude Local Cleanup

Safely audit, back up, and clean Claude Code / Claude Desktop local state on macOS with a whitelist-driven script.

UtilitiesIntermediate★ 453⑂ 42AI score 9/10Last updated: Oct 19, 2026

What it does

  • Runs a read-only audit first via scripts/claude_cleanup.py --audit so you see exactly what exists.
  • Before any write, makes and verifies a full copy of ~/.claude plus a backup of ~/.claude.json.
  • Auto-queues regenerable caches and logs (~/.claude/cache, ~/Library/Caches/claude-cli-nodejs, ~/Library/Logs/Claude, crash reports, etc.) without item-by-item prompting.
  • Everything removed goes to a timestamped trash directory, never a permanent delete.
  • Hard-protects projects, sessions, history.jsonl, skills, plugins, hooks, settings.json, Git repos and project folders.
  • Optional risky actions, each explicitly chosen: local ID rotation, Keychain credential removal, Claude Desktop login reset or app removal, minimal-prompt mode (CLAUDE_CODE_SIMPLE=1), Asia/Taipei timezone change.
  • Inherits existing telemetry env values instead of flipping them.

Who it's for

  • macOS users whose long-running Claude Code install has accumulated caches and logs.
  • Anyone who wants disk space back without losing session history or settings.
  • People reinstalling or re-authenticating Claude Desktop from a clean state.
  • Anyone uncomfortable hand-rolling rm -rf and who wants a recoverable backup.

Examples

  1. "Just tell me what Claude files are on this machine" → audit-only run, no writes.
  2. "Clear caches and logs but keep every session transcript" → auto safe-cleanup list only.
  3. "Log me out of the CLI and remove Claude Desktop entirely" → pick the risk items, then type CONFIRM once.

Caveats: macOS only, requires python3, cannot kill running processes for you, and the write phase should be run from a normal terminal (not from Claude Code itself). Explicitly not for ban or platform-risk evasion.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/suyuan2022/suyuan-skill/HEAD/claude-cleanup/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on AI Skill Mart.
Copy the claude-cleanup folder from the GitHub repo suyuan2022/suyuan-skill into my ~/.claude/skills/claude-cleanup/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/suyuan2022/suyuan-skill.git /tmp/suyuan-skill && mkdir -p ~/.claude/skills && cp -r /tmp/suyuan-skill/claude-cleanup ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open Terminal on macOS.
  2. Clone the repo: git clone https://github.com/suyuan2022/suyuan-skill.git /tmp/suyuan-skill
  3. Create the skills directory: mkdir -p ~/.claude/skills
  4. Copy the skill in: cp -r /tmp/suyuan-skill/claude-cleanup ~/.claude/skills/
  5. Verify the helper script is present: ls ~/.claude/skills/claude-cleanup/scripts/
  6. Do a dry, read-only check first: python3 ~/.claude/skills/claude-cleanup/scripts/claude_cleanup.py --audit
  7. For the real run, quit Claude Code and Claude Desktop, use a normal terminal, run python3 ~/.claude/skills/claude-cleanup/scripts/claude_cleanup.py, review the expanded list, and type CONFIRM.
View source on GitHub ↗License: MIT