cache-metrics

Analyze codex cache metrics and return JSON or formatted output.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill analyzes codex cache metrics and delegates to the CLI to produce formatted metrics.

Core Features & Use Cases

  • Category-based stats: cache, performance, storage
  • Historical context: optional history inclusion
  • Formatted output: human-readable display or raw JSON

Quick Start

Request cache metrics for the default category and format.

Frequently Asked Questions about cache-metrics

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

FAQPage Schema
How do I analyze codex cache performance and storage metrics?

Cache metrics analyzes codex cache to generate comprehensive statistics on performance, storage usage, and health status. It produces formatted metrics across cache, performance, sources, and storage categories through the Fractary codex CLI.

Can I view cache health metrics with historical context?

Yes, cache metrics supports optional history inclusion to track performance trends over time alongside current cache statistics, enabling you to identify patterns in cache behavior and storage changes.

What output formats does cache analysis support?

Cache metrics returns either human-readable formatted output or raw JSON, letting you choose the format that fits your reporting, monitoring, or downstream analysis needs.

What dependencies do I need to run cache metrics?

Cache metrics requires bash, jq, and curl. It delegates all operations to the Fractary codex CLI, so the CLI must be installed and available in your environment.

Does cache metrics modify the codex cache data?

No, cache metrics never modifies cache data. It strictly analyzes and reports statistics while preserving all CLI error messages verbatim, ensuring safe, read-only introspection.

What metrics categories can cache analysis generate?

Cache metrics produces statistics across four categories: cache (hit/miss rates and efficiency), performance (operation timings), sources (data origin tracking), and storage (capacity and usage analysis).