codex-app-cleanup
CommunityClean stale Codex desktop refs and worktrees.
Authorpaulchiu
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Cleans stale Codex desktop app state such as dead project picker entries, invalid local environment refs, and obsolete worktree pairings, ensuring the UI reflects current reality and reducing confusion from outdated references.
Core Features & Use Cases
- Detects and removes dead project roots from Codex's project picker and clears related labels to prevent confusion.
- Reconciles pairing caches and environment references that no longer point to valid directories, reducing stale shortcuts.
- Safe, reversible cleanup with backups and validation to minimize disruption when Codex UI still shows old projects or envs after worktree cleanups.
Quick Start
Identify and prune missing paths from the global state and pairing caches, then relaunch Codex.
Dependency Matrix
Required Modules
None requiredComponents
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: codex-app-cleanup Download link: https://github.com/paulchiu/dotfiles/archive/main.zip#codex-app-cleanup Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.