Highlights
- Codex works best as its own first view
- Total and session views answer different questions
- Combined reporting is a second step, not the first
Guide
A practical guide to tracking OpenAI Codex CLI usage locally with vibestats.
Highlights
Relevant commands
npx vibestats codexnpx vibestats usage codex --totalnpx vibestats codex --sessionsStep 1
Run `npx vibestats codex` so the report reflects Codex CLI usage only.
Step 2
Use totals, models, or sessions depending on whether you care about spend, model mix, or session behavior.
Step 3
Move to combined reporting after you understand the Codex-only picture, not before.
Most AI coding reporting problems are not about one missing command. They are about choosing the right surface: daily usage, wrapped summaries, activity heatmaps, cost views, or shareable aggregate pages.
This guide stays focused on vibestats workflows and the pages already documented in the public command reference, so you can move from local data to a readable result quickly.
FAQ
Start with the relevant command, verify the output locally, then decide whether you need a share page, a wrapped summary, or a heatmap for communication.
No. vibestats works from local usage artifacts and only turns aggregate results into hosted pages when you explicitly publish them.
Related pages