vibestats/Guides/How to track Codex CLI usage

Guide

How to track Codex CLI usage

A practical guide to tracking OpenAI Codex CLI usage locally with vibestats.

Intent
Guide
Focus
How to track Codex CLI usage is a practical workflow page for turning local AI coding usage into something readable and repeatable.

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

Relevant commands

npx vibestats codexnpx vibestats usage codex --totalnpx vibestats codex --sessions

Step 1

Switch to the Codex source

Run `npx vibestats codex` so the report reflects Codex CLI usage only.

Step 2

Choose the right grouping

Use totals, models, or sessions depending on whether you care about spend, model mix, or session behavior.

Step 3

Combine only when needed

Move to combined reporting after you understand the Codex-only picture, not before.

Why this guide exists

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.

What to expect

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

What is the fastest way to approach how to track codex cli usage?

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.

Do I need to upload raw conversations for these guides?

No. vibestats works from local usage artifacts and only turns aggregate results into hosted pages when you explicitly publish them.

Related pages

Continue by intent

View all guides