aiClean

Overview

aiClean organizes local Claude Code and Codex storage. It determines age from user sends and completed assistant messages, rather than filesystem modification dates. Conversations whose last real message predates the current month can become cleanup candidates. Releases are available for macOS and Windows x64.

Main Functions

• Inspect candidates, message dates, and source bytes with the read-only check command
• Enable monthly cleanup explicitly, inspect it with status, and disable it with stop
• Verify and record original files and database rows before moving recovery bundles to native OS Trash
• Restore the latest or a selected batch with undo, including recovery from interrupted operations

Design and Usage Boundaries

Unknown dates, unfinished work, active goals, and unsafe session relationships are skipped. Installation alone does not enable cleanup. The scope is local Claude Code and Codex data; cloud ChatGPT history is excluded.

Trash disposal remains under OS control, so moving data does not immediately reclaim disk space. Restore requires the recovery bundle to remain available and refuses to overwrite conflicting existing data.