cache-clear

Clear codex cache entries by scope with dry-run previews and confirmation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/fractary/claude-plugins --skill cache-clear
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cache-clear
Source: https://github.com/fractary/claude-plugins/tree/main/plugins/codex/skills/cache-clear
Command: npx skills add https://github.com/fractary/claude-plugins --skill cache-clear

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, jq, and includes scripts (resource) components.

What problem does it solve?

Removes codex cache entries with safety checks and optional dry-run, delegating to the CLI.

Core Features & Use Cases

  • Validate scope (all/expired/pattern)
  • Dry-run previews with detailed results
  • Execute deletions with atomic index updates

Quick Start

Clear all cache entries with a dry-run preview, then proceed if confirmed.

Frequently Asked Questions about cache-clear

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clear codex cache entries to free up storage?

Clear codex cache entries by running the cache-clear Skill with your desired scope—all, expired, or pattern-based—to reclaim storage and remove stale items. The Skill provides a dry-run preview before executing deletions, letting you review what will be removed before confirmation.

Can I preview cache deletions before actually removing entries?

Yes, cache-clear includes a dry-run mode that shows detailed results of what would be deleted without making changes. Review the preview output, then proceed with explicit confirmation to execute the actual deletion.

What scopes does cache-clear support for removing entries?

Cache-clear supports all (remove everything), expired (remove only stale entries), and pattern-based scopes to target specific cache entries. Delegate operations to the CLI via cli-helper for atomic index updates and destructive-safety enforcement.

How does cache-clear ensure safety when deleting cache data?

Cache-clear enforces destructive-safety rules requiring explicit user confirmation before deletions, preserves CLI error messages for diagnostics, and executes atomic index updates through cli-helper to maintain data consistency.

What tools do I need to run cache-clear?

Cache-clear requires bash and jq as dependencies. These tools enable the Skill to parse JSON output from the codex CLI and execute cache-clearing operations safely with proper validation and confirmation workflows.