cc-cleaner

English | 中文

The cache cleaner for the AI Coding era.

cc = Claude Code / Cursor / Copilot / Coding Cache

In the AI Coding era, your disk fills up 10x faster—rapid project iteration, massive conversation logs, exploding package caches. cc-cleaner knows exactly what to clean.

Install

curl -sSL https://raw.githubusercontent.com/elexingyu/cc-cleaner/master/install.sh | bash

Other installation methods

pipx install cc-cleaner   # pipx
uv tool install cc-cleaner # uv
pip install cc-cleaner     # pip

Usage

cc-cleaner status          # See what's eating your disk
cc-cleaner clean           # Interactive mode (select what to clean)
cc-cleaner clean all       # Clean all safe caches
cc-cleaner clean claude    # Clean specific tool
cc-cleaner clean all -n    # Dry run (preview only)

Interactive mode (just run cc-cleaner clean):

• Use ↑/↓ to navigate
• Space to toggle selection
• s for safe items only, a for all, n for none
• Enter to confirm, q to cancel

Example output:

$ cc-cleaner status

                        Development Cache Status
┏━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┓
┃ Cleaner   ┃ Description                  ┃     Size ┃   Risk   ┃
┡━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━┩
│ uv        │ uv Python package cache      │   5.9 GB │   Safe   │
│ npm       │ npm package cache            │   1.2 GB │   Safe   │
│ claude    │ Claude Code logs & telemetry │ 299.6 MB │   Safe   │
│ cargo     │ Cargo registry cache         │ 102.5 MB │   Safe   │
└───────────┴──────────────────────────────┴──────────┴──────────┘

Total cleanable: 7.5 GB

Supported Cleaners (22 total)

Category	Tools
AI Coding	Claude Code
AI/ML Models	huggingface, pytorch, whisper, ollama
JavaScript	npm, yarn, pnpm, bun, nvm
Python	pip, uv, virtualenv
Browser	browser-cache (Chrome/Safari/Firefox), playwright, browser-tools (Puppeteer/Selenium)
Others	cargo, go, gradle, cocoapods, homebrew, docker

Risk Levels

Level	Cleaned By Default	Examples
Safe	Yes	Download caches, logs, telemetry
Moderate	--force	Conversation transcripts, shared stores
Dangerous	--force	Docker system prune

Contributing

PRs welcome for Cursor, GitHub Copilot, Windsurf, and other AI coding tools!

License

MIT