v0.3.0 - Safe thread archive repair

Highlights

• Add thread-ID-based archive repair for an older active Codex thread that remains visible after the supported archive action fails.
• Add scripts/repair_thread_archive.py, which runs read-only by default and requires both the resolved current thread ID and --apply before changing state.
• Back up the active SQLite database, target rollout, global state, compatibility index, and config before repair.
• Normalize legacy Windows \\?\ paths for filesystem access while preserving the database's stored path style.
• Copy and hash the archived rollout before updating only rollout_path, archived, and archived_at for the selected thread.
• Verify SQLite integrity and require app-level active-list, archived-list, and conversation-read checks before reporting success.
• Update the skill routing, UI metadata, flow diagram, and English and Korean documentation.

Safety boundaries

The repair helper refuses to run when:

• the target is the current thread;
• the current thread ID was not supplied for an apply operation;
• thread_source is not user;
• more than one top-level state database contains the target;
• the schema is unsupported;
• the rollout is missing or outside sessions;
• the archive destination has a different size or SHA-256.

Archive repair is not deletion. It preserves the conversation, leaves global UI state and compatibility indexes unchanged, and creates a recoverable backup before mutation.

Validation

• 9 Windows regression tests passed, including the real-world recovery case where a matching archive copy already exists after an interrupted attempt.
• Python compilation passed.
• Codex quick_validate.py passed.
• A live read-only check against the repaired thread returned already_archived and resolved its archived rollout.
• SVG XML parsing and git diff --check passed.
• All changed text files were verified as UTF-8 without BOM, CRLF only, with no replacement-character corruption.

Upgrade

Ask Codex to install or update the skill from:

$skill-installer Install the skill from https://github.com/cku3987/codex-local-cleanup-skill/tree/main/codex-local-cleanup

한국어 요약

공식 아카이브 기능이 실패한 뒤에도 활성 목록에 남아 있는 구형 세션을 ID로 지정해 안전하게 복구할 수 있습니다. 기본 실행은 읽기 전용이며, 실제 적용 전 현재 세션 제외 확인과 자동 백업을 수행합니다. 대상 세션 JSONL을 해시 검증한 뒤 아카이브로 옮기고 해당 스레드의 아카이브 필드만 갱신합니다. 현재 세션, subagent·automation, 다중 DB, 경로 이탈, 파일 불일치 사례는 자동으로 거부합니다.

v0.2.0 - Current Codex compatibility update

Highlights

• Updated project discovery for current Codex Desktop metadata: local-projects, thread-project-assignments, and multi-folder rootPaths.
• Prefer the supported Codex App Server thread/delete lifecycle before direct JSONL or SQLite repair.
• Treat sqlite/codex-dev.db as a derived Desktop catalog and legacy state as compatibility evidence, not the primary deletion source.
• Separate visibility, archive, storage, and repair scopes so one cleanup request does not imply broader deletion.
• Preserve active projects, projectless chats, automation threads and runs, generated workspaces, subagents, and the current thread by default.
• Disable implicit invocation so cleanup runs only when explicitly requested.
• Update the flow diagram and English, Korean, Japanese, Chinese, Russian, German, French, and Spanish documentation.

Validation

• Loaded by the current Codex App Server with the skill enabled and zero load errors.
• Read-only thread inventory matched the active SQLite state.
• Verified integrity of the current, Desktop catalog, and legacy SQLite databases.
• Verified the installed skill matches the repository copy and preserved UTF-8 text without character corruption.

한국어 요약

최신 Codex Desktop의 프로젝트 메타데이터 구조와 App Server 절차에 맞게 스킬을 갱신했습니다. 표시 정리, 아카이브 정리, 용량 정리 범위를 분리하고 현재 프로젝트, 일반 채팅, automation, 현재 작업을 기본적으로 보존하도록 안전 규칙을 강화했습니다.

v0.1.0 - Initial public release

Initial public release of Codex Local Cleanup Skill.

Highlights:

• Cleans stale local Codex Desktop project/thread metadata under ~/.codex.
• Targets deleted project traces, non-active project threads, archived threads, session indexes, config trust entries, and SQLite rows.
• Backs up affected metadata before cleanup.
• Preserves saved projects, projectless chats, and the current thread by default.
• Includes README translations and a cleanup flow diagram.

Install with Codex skill-installer:
$skill-installer Install the skill from https://github.com/cku3987/codex-local-cleanup-skill/tree/main/codex-local-cleanup