Keep Codex Fast

Diagnose Codex Desktop or CLI local-state bloat and safe recovery options. Use when sessions, archived history, logs, worktrees, or stale Codex config may be making Codex feel slow.

9 stars 4 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jscraik/Agent-Skills --skill keep-codex-fast
Manual install
git clone --depth 1 https://github.com/jscraik/Agent-Skills.git /tmp/Agent-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills/Skills/agent-ops/keep-codex-fast ~/.claude/skills/keep-codex-fast

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Keep Codex Fast

## Philosophy
- Diagnose before cleanup; the first pass is evidence, not mutation.
- Preserve continuity before reclaiming space; old chats are work history until a handoff exists.
- Treat `~/.codex` as live control-plane state: backup first, require explicit mutation confirmation, and leave restore evidence behind.
- Use Harness Engineering language: current state, evidence, decision, action, verification, handoff.

## When To Use
- Codex Desktop or CLI feels slower after many long-running chats.
- The user wants safe inspection, backup, archival planning, or handoff-first chat retirement for Codex local state.
- A recurring Codex maintenance reminder is requested, with report-only behavior.

## Avoid
- Automatic cleanup without a fresh report.
- Mutation while Codex is running or process detection cannot prove it is safe.
- Deleting chats, worktrees, logs, skills, plugins, memories, rules, or automations.
- Rewriting `config.toml` from broad heuristics without explicit prune confirmation.

## Inputs
- Codex home, defaulting to `CODEX_HOME` or `~/.codex`.
- Intent: report, backup-only, apply archive actions, create a handoff, or create a report-only reminder.
- Age thresholds, exact apply confirmation, and optional details mode for raw IDs, titles, paths, and process paths.

## Outputs
- Local-state report with candidate counts and sizes.
- Backup path when artifacts are written.
- Mutation plan before apply.
- Validation evidence after apply.
Read the full skill on GitHub

Details

Skill name
keep-codex-fast
Path
Skills/agent-ops/keep-codex-fast/SKILL.md
License
Apache-2.0
Repo updated
16 November 2026

FAQ

What does the Keep Codex Fast skill do?

Diagnose Codex Desktop or CLI local-state bloat and safe recovery options. Use when sessions, archived history, logs, worktrees, or stale Codex config may be making Codex feel slow.

How do I install the Keep Codex Fast skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jscraik/Agent-Skills --skill keep-codex-fast. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Keep Codex Fast popular?

It lives in jscraik/Agent-Skills, which has 9 GitHub stars and 4 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.