Agent skill · operations · aradotso
keep-codex-fast-maintenance
Backup-first skill for inspecting, archiving, and maintaining local Codex state to keep it fast, clean, and recoverable.
Why this skill is useful
Adds executable scripts for inspecting and maintaining Codex state, enabling efficient archiving and cleanup workflows that the AI cannot generate on its own.
What it needs
Requires python installed locally. About 6k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Keep Codex Fast Skill by ara.so — Daily 2026 Skills collection. A backup-first maintenance skill for local Codex state. When Codex starts feeling heavy after weeks of chats, terminals, logs, worktrees, and project history, this skill gives you a safe, inspectable workflow to reduce drag without losing context. Core rule: Make handoffs first. Archive, don't delete. Apply changes only when you are ready. --- Installation Ask Codex directly: Or clone manually into your Codex skills directory: --- Mental Model Layer Purpose --- --- Chats Execution context Handoff docs Memory and continuity Archives History, not deletion Fresh threads Speed Never delete. Always archive. The script moves state into archive folders and writes backup/restore artifacts before applying any change. --- CLI — Key Commands All commands run from the project root. The script is read-only by default. 1. Inspect Only (Safe, No Writes) Reports: active session size, archived session size, extended path candidates, old session candidates, worktree candidates, log size, top Node/dev processes. Nothing is mutated. 2. Detailed Report (Raw IDs, Titles, Paths) Shows thread IDs, chat titles, file paths, and process paths. Use when you need to identify specific sessions or worktrees before archiving. 3. Backup Only (No Move/Archive) Creates backup artifacts of current Codex state without moving or modifying anything. Run this before any apply step as an extra safety net. ⚠️ Backup folders contain private local Codex metadata. Keep them on your machine. Do not publish or share without reviewing contents. 4. Apply Maintenance Archives old non-pinned sessions, moves stale worktrees, rotates large logs2.sqlite files, prunes dead/temp project references in config.toml, and normalizes Windows \\?\C:\... path mismatches in SQLite text fields. 5. Wait for Codex to Exit Before Applying Holds until no Codex process is detected, then applies maintenance. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/keep-codex-fast-maintenance