Skills
.Work. You
Rest

crew-cleanup

Community

Tidy stale Codex crew state safely.

Personal & Entrepreneur#codex#cleanup#retention policy#dry-run#local files#crew state#workspace hygiene
AuthorJoeCP17
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Cleans up old Codex crew state files that accumulate in the local .codex/crew/ directory and can clutter runs, cycles, and seed artifacts.

Core Features & Use Cases

  • Dry-run cleanup planning: Shows exactly which files and directories would be deleted before making changes.
  • Safe optional deletion: Requires --apply to actually delete targets after the user sees the dry-run output or explicitly requests it.
  • Targeted retention policy: Removes older seed-*.md (excluding the seed-latest.md target), stale runs/<run-id>/ and cycles/<cycle-id>/, and prunes history files by line count (keeping the newest 200 lines).
  • Use case: When you’ve run multiple Codex crew sessions over weeks, use this skill to restore a clean workspace without accidentally deleting the most recent seed state.

Quick Start

Run crew-cleanup in dry-run mode to preview what will be deleted from .codex/crew/ before applying changes.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: crew-cleanup
Download link: https://github.com/JoeCP17/LLM-Dot-files/archive/main.zip#crew-cleanup

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.