Codex Job Usage Add-on

This add-on makes Codex report estimated token usage and USD cost for each completed user task by diffing ccusage snapshots.

It does not include ccusage; install that separately first:

npm install -g ccusage

Then install this add-on:

./install.sh

The installer:

• copies the job-usage skill to ~/.codex/skills/job-usage
• installs codex-job-usage to ~/.local/bin/codex-job-usage
• appends the always-on task tracking instructions to ~/AGENTS.md

After installation, start a new Codex session or reload the working context so the new AGENTS.md instructions are picked up.

Manual Usage

codex-job-usage start "task-name"
codex-job-usage finish "task-name"
codex-job-usage status

Notes

• Usage is based on ccusage codex daily --json totals.
• If multiple Codex sessions run at the same time, deltas can include usage from those sessions too.
• The final response tokens may not be included because the finish snapshot runs before the final answer is sent.