Skip to main content
Software

Public · MIT License

codex-hygiene

A compact, read-only Codex skill for current-context diagnostics and private local activity reviews.

Open codex-hygiene on GitHub

What it is

codex-hygiene measures the context and tool surfaces available to Codex Desktop while keeping full logs, configuration, prompts, responses, and secrets private.

It can run a quick current-context measurement or review an explicit period from 1 to 90 days. Reports separate observed evidence, interpretation, and unknowns.

What you can do

  • Measure recent tool-list and per-thread token telemetry.
  • Review an explicit 1–90 day period in Markdown or JSON.
  • Summarize the current Codex profile, including plugins, MCP state, Apps availability, and project configuration.
  • Suggest scoped, reversible hygiene steps after measurement.

What you need

  • Codex Desktop on macOS or another Unix-like system.
  • Bash, sqlite3, Perl, awk, and sort for the compact measurement.
  • Python 3 for activity reviews.

How to use it

  1. Install the skill

    Clone the repository into your user-level Codex skills folder, normally ~/.agents/skills/codex-hygiene.

  2. Open it in Codex

    Invoke $codex-hygiene. Restart Codex if the newly installed skill has not appeared yet.

  3. Choose a measurement

    Run the compact current-context check or choose an explicit 1–90 day activity review.

  4. Review before changing anything

    Use the measured evidence and suggested reversible steps to decide whether a context or configuration change is useful.