Local Usage Monitor

SKILL.md

---
name: codex-usage-monitor
description: Install and maintain a local desktop widget for monitoring Codex usage and session context pressure.
---

# Codex Usage Monitor

Use this skill to install a local macOS desktop widget that displays Codex usage from local files. The widget is designed for people who run Codex locally and want a small always-visible usage card.

The widget reads local Codex state from the user's home directory. It does not upload data, call APIs, or require credentials. It is best effort because Codex local storage may change between releases.

Install from the bundled scripts when available. Validate by running the widget Python script and checking that it prints JSON with ok set to true.