CODEX / DASHBOARD
Native macOS · Local-first · Open source

Your Codex activity,
finally visible.

Understand the work behind the work. Codex Dashboard turns your local activity into a clear view of projects, models, tokens, tools, time, and API-equivalent cost.

Run from source Source code
01 ACTIVITY / OVERVIEW
Codex Dashboard overview showing activity metrics and a usage trend chart
READ ONLY ● YOUR MAC
CONVERSATIONS✦RAW EVENTS✦PROJECTS✦SESSIONS✦MODELS✦TOKENS✦TOOLS✦
NEW / CONVERSATION DEBUGGER

See the exchange.
Down to the event.

Metrics tell you what happened. The debugger shows how it happened—without sending the conversation anywhere.

SENTPrompts · tool results
RECEIVEDResponses · tool calls
Conversation Debugger showing sent and received events in a readable timeline
TWO VIEWS / ONE ROLLOUT

Readable when you want context.
Raw when you need proof.

Follow messages, reasoning summaries, tool calls, and tool results in sequence. Filter the model exchange by direction, then switch to the original JSON to investigate the exact event shape.

  • 01Expand only the events that matter
  • 02Filter by sent or received
  • 03Copy with credential redaction by default
Conversation Debugger displaying an original received JSON event
RAW / JSON The original event, still on your Mac.
01 / SEE THE SYSTEM

From portfolio
to single prompt.

Move from your entire Codex history to one project, one session, or one model—without losing the thread.

01

Follow every project

Compare workspaces, expand their sessions, and see how activity changes over time.

Projects view with workspace metrics and session details
02

Know your models

Compare volume, runtime, cache behavior, session count, and estimated cost.

Model portfolio with token and cost comparison
03

Keep the pulse nearby

Check remaining quota and today's key metrics right from your menu bar.

Codex Dashboard menu bar popover
02 / LOCAL BY DESIGN

Your work stays
your work.

⌁

Read-only source

Opens your local Codex index read-only and enriches metrics from local rollout files.

◉

On-demand inspection

Conversation payloads load only when you open the debugger, stay in memory, and are never added to history.

⌂

Local history

Your durable metrics database lives in Application Support on your Mac.

DATA PATH ~/Library/Application Support/CodexDashboard/metrics-v1.sqlite
03 / RUN IT

Make the invisible
measurable.

Requires macOS 14 or later and a Swift 6.1-compatible Xcode toolchain.

zsh
$ git clone [email protected]:chunyang-wen/CodexDashboard.git
$ cd CodexDashboard
$ swift run CodexDashboard