Add claude clean command to manage cache and logs
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
Claude Code accumulates significant disk space over time from:
- Debug logs (can reach 3GB+)
- Old proxy databases (1GB+ per version)
- Proxy session files (171+ log files, 30MB)
- Project caches (2GB+)
- File history (50MB+)
This accumulation can cause performance issues and crashes.
Proposed Solution
Add a built-in claude clean command with two modes:
# Regular clean (safe, keeps project data)
claude clean
# Deep clean (removes project caches too)
claude clean --deep
What it should clean:
Regular clean:
- Debug logs older than N days
- Old proxy databases (keep latest version only)
- Old proxy session files (keep current session)
- File history
- Shell snapshots
- Old todos
Deep clean:
- Everything above +
- Project caches
- Command history
Alternative Solutions
Users must manually identify and delete these files, or write custom cleanup scripts.
Impact:
In my case, ~/.claude grew from 184MB to 6.5GB over a few weeks, contributing to stability issues. After cleanup: 97% reduction (6.5GB → 170MB).
Priority
Medium - Would be very helpful
Feature Category
CLI commands and flags
Use Case Example
claude clean
claude clean --deep
Additional Context
_No response_
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗