AIToday
AI Coding AssistantsOpen-Source AIZenn AI/MLPublished: Oct 18, 2026, 10:00 JST

aiClean CLI moves old Claude Code, Codex chats to trash

aiClean CLI moves old Claude Code, Codex chats to trash

3 Key Points

  1. What happened

    aiClean, a Rust CLI released at v0.1.2, moves old Claude Code and Codex conversations to the OS trash. It judges age by the last real message, not file dates.

  2. Why it matters

    Users pruning local AI coding logs by folder date could wipe recently resumed chats. aiClean skips ambiguous, in-progress, or unverifiable conversations and is read-only until a run.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, in your inbox every morning.

Context & Analysis

aiClean targets a specific hazard in local AI coding workflows: conversations can be resumed long after their files were last touched, so pruning by folder date risks deleting active threads. The tool instead inspects the last real message, counting user submissions and completed assistant responses, and refuses to decide when dates are unknown or a conversation has unfinished work, an active goal, or child-session relationships.

Safety is built around the OS trash rather than permanent deletion. aiClean verifies that the OS is set to auto-delete trash after 30 days before proceeding, checks Finder settings on macOS and Storage Sense policy on Windows, and will not change OS settings itself. It also declines to run when the apps using Claude Code or Codex are open, and it never force-quits them.

The release notes are candid about limits. On the Windows test machine, Storage Sense cleanup conditions were unverified, so real-data cleanup was not performed there. Intel Mac builds exist but Rosetta execution is untested. Both macOS and Windows binaries lack notarization or Authenticode signing, so some security policies may prompt at runtime. Space may not free up immediately because trashed data still occupies disk, and the SQLite row deletion does not guarantee file shrinkage.

FAQ
What counts as an old conversation in aiClean?
A conversation whose last actual user message or completed assistant response occurred before 0:00 on the first day of the current month in the OS timezone. File creation, update, archive, tool-execution, and metadata timestamps are not used.
Does aiClean delete conversations permanently?
It moves the original logs and required database rows to the OS trash as a restoration bundle, then removes the source data after recording the move. It does not empty the trash, and undo can restore the latest un-restored batch per service.
When can cleanup run automatically?
Registration sets a monthly schedule at 03:30 local time on the 10th, via launchd on macOS or Task Scheduler on Windows. Manual run is allowed only on or after the 10th, once per service per month.

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.

Questions and answers are published on this page.

Related Articles

Next articleMeta pulls scraping clause from business terms after Nieman Lab scrutiny