v0.1.0 - First Usable Codex Cleaner

This is the first usable release of Codex Cleaner.

Highlights

Scan local archived Codex sessions.
Show readable Chinese, English, and mixed-language conversation titles.
Map archived sessions to their local workspace folders.
Clean by numbered row, multiple rows, title keyword, session id, archive file, or project path.
Move deleted content to Codex_Trash by default.
Support explicit permanent deletion with --permanent --yes.
Include a conversational Codex Skill workflow.
Bundle the cleanup script inside the Skill folder so Skill installs are self-contained.
Support batch cleanup with --indexes 2,3,5.

clean is a dry run unless --yes is provided.
Permanent deletion requires both --permanent and --yes.
Local workspace cleanup is limited to ~/Documents/Codex by default.
This tool removes local archived logs and files only. It does not delete cloud-side ChatGPT or Codex history.

Validated on Windows with:

python -m unittest discover -s tests
python -m compileall skills tests scripts

$skill-installer install https://github.com/manganeseboy/codex-cleaner/tree/main/skills/codex-cleaner

After installing, ask Codex:

Use codex-cleaner to scan my archived conversations.