Codex Hygiene Skill

Skill by ara.so — Codex Skills collection.

This skill provides expertise in using codex-hygiene, a tool for auditing and tuning Codex Desktop context and tool surfaces. It measures recent telemetry, reviews MCP/app/skill availability, and helps keep long-running goal workflows scoped to current work.

What Codex Hygiene Does

Codex Hygiene is a diagnostic skill that:

• Measures token usage: Queries Codex Desktop SQLite telemetry databases to show recent token consumption per thread and window
• Audits tool availability: Distinguishes actual tool calls from tool availability, enabled state from cached inventory
• Identifies bottlenecks: Helps correlate elevated usage with app surface size, MCP/plugin state, snapshot reuse, stale project stanzas, long-thread replay, or background fan-out
• Suggests reversible hygiene: Recommends cleanup steps without deleting logs, caches, or projects
• Maintains quality: Keeps long-running goal work quality-aware by narrowing replay and tool scope

Installation

Install codex-hygiene into your Codex skills directory: