Codex Lens

A detailed, local-first dashboard for Codex usage. It reads ~/.codex/sessions/**/*.jsonl directly and never uploads session data.

Run

cd /home/louis/dev/codex-lens
npm start

Open http://127.0.0.1:4173. Set PORT or CODEX_HOME to override either default.

What it measures

• Input, cached input, output, reasoning output, and total tokens
• Cache hit rate, model calls, sessions, turns, and active task duration
• Daily usage and estimated API-equivalent cost
• Breakdowns by model, project/workspace, and session
• Date, project, and model filtering

Cost is an estimate, not a bill. It applies current standard API prices per 1M tokens to the model recorded for each usage event. Unknown, local, experimental, and unpriced model slugs are excluded and pricing coverage is shown in the UI. Reasoning tokens are already part of output tokens and are not charged twice.

Pricing source: OpenAI API pricing, captured 2026-07-10. Edit the prices table in server.js as rates change.