Add claude clean command to manage cache and logs

[fkart]

Preflight Checklist

• I have searched existing requests and this feature hasn't been requested yet
• 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

[github-actions]

Found 3 possible duplicate issues:

1. History accumulation in .claude.json causes performance issues and storage bloat #5024
2. Memory leak: Missing cleanup for /tmp/claude-*-cwd working directory tracking files #8856
3. [BUG] todos/ never gets cleaned up #6853

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[fkart]

The others suggest issues, but not clearly asking a proper clean prompt, similar to reset. Reset is good it is doing more damage than one would like.

[github-actions]

This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.

[github-actions]

This issue has been automatically closed due to 60 days of inactivity. If you're still experiencing this issue, please open a new issue with updated information.

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.