v0.1.3 Release

v0.1.3 - Updated Demo GIF

This release refreshes the GitHub README demo GIF so it matches the current Codex Cleaner skill workflow.

Highlights

• Regenerate assets/demo.gif for the latest interaction flow.
• Show the recommended skill-first experience:
  • scan archived conversations
  • choose conversations by readable numbered rows
  • choose one cleanup mode from the four-option menu
  • preview affected local paths before cleanup
  • confirm before applying changes
• Include the current cleanup choices in the animation:
  • conversation-only cleanup
  • project-files-only cleanup
  • cleanup of both conversation and project files
  • permanent deletion as a separate dangerous option
• Add Chinese text to the animation so bilingual users can understand the flow.
• Update the demo generation script so future GIF updates can be reproduced.

Validation

Validated on Windows with:

python .\scripts\make_demo_gif.py
python -m unittest discover -s tests
python -m compileall scripts skills tests

v0.1.2 Release

v0.1.2 - Documentation Refresh

This release refreshes the GitHub-facing documentation so it matches the current Codex Cleaner workflow.

Highlights

• Make the Codex Skill workflow the recommended path for non-technical users.
• Document the four cleanup choices directly in the README:
  • delete archived conversation only and keep project files
  • delete local project files only and keep the archived conversation
  • delete both conversation and project files by moving them to Codex_Trash
  • permanently delete everything, with an explicit warning
• Update the Chinese README with the same current workflow.
• Update CLI examples to prefer --conversation-only and --files-only for partial cleanup.
• Update the skill card prompt to mention the numbered cleanup menu.
• Align project metadata with the current release version.

For Installed Users

Installed users do not receive automatic push updates from GitHub. Ask Codex:

I already installed codex-cleaner. Please remove the old local codex-cleaner skill and reinstall the latest version from:
https://github.com/manganeseboy/codex-cleaner/tree/main/skills/codex-cleaner

Then restart Codex so the new skill instructions are loaded.

Validation

Validated on Windows with:

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

v0.1.1 Release

v0.1.1 - Simpler Cleanup Choices

This release improves the non-technical user flow for the Codex Cleaner skill.

Highlights

• Add conversation-only cleanup with --conversation-only.
• Add files-only cleanup with --files-only.
• Update the Codex skill workflow so users choose from one simple numbered cleanup menu:
  • delete archived conversation only and keep project files
  • delete local project files only and keep the archived conversation
  • delete both conversation and project files by moving them to Codex_Trash
  • permanently delete everything, with an explicit danger warning
• Keep permanent deletion as an explicit opt-in path that still requires final confirmation.
• Document how already-installed users can update the skill from GitHub.
• Update English and Chinese README guidance.

Updating an Installed Skill

Installed users do not receive automatic push updates from GitHub. Ask Codex:

I already installed codex-cleaner. Please remove the old local codex-cleaner skill and reinstall the latest version from:
https://github.com/manganeseboy/codex-cleaner/tree/main/skills/codex-cleaner

Then restart Codex so the new skill instructions are loaded.

Safety

• Default cleanup still moves files to ~/Documents/Codex_Trash.
• Permanent deletion still requires --permanent --yes.
• The skill now presents permanent deletion as a separate dangerous menu option.
• This tool removes local archived logs and local files only. It does not delete cloud-side ChatGPT or Codex history.

Validation

Validated on Windows with:

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

v0.1.0 - First Usable Codex Cleaner

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.

Safety

• 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.

Validation

Validated on Windows with:

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

Install Skill

$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.