Add claude clean command to manage cache and logs

Resolved 💬 5 comments Opened Nov 14, 2025 by fkart Closed Jan 16, 2026

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_

View original on GitHub ↗

This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗