Usage

A Codex skill for reporting local Codex token usage from local SQLite and JSONL logs.

The skill emphasizes:

• activity buckets such as planning, code edits, git, checks, browser work, and exploration
• fresh versus cached input tokens
• output and reasoning tokens
• common ways to reduce unnecessary token spend

Install

Copy the usage/ folder into your local Codex skills directory:

mkdir -p ~/.codex/skills
cp -R usage ~/.codex/skills/usage

Then restart or refresh Codex so the skill list reloads.

Use

Invoke the skill in Codex with:

$usage

You can also ask natural-language questions such as:

What am I spending Codex tokens on?

Privacy

This skill is read-only. It inspects Codex logs on your local machine and does not upload logs or token data anywhere.

Notes

The activity buckets are approximate heuristics. Codex records token usage at turn/session-log granularity, so the report is useful for understanding broad patterns, not exact per-command billing.

Development

Run the test suite with:

python3 -m unittest discover -s usage/tests