Repository navigation
Codex Costs v1.0.0
Codex Costs v1.0.0
A small, native macOS utility for estimating the current Standard API token cost of local Codex conversations.
Download and install
- Download Codex-Costs-v1.0.0-macOS-universal.zip from the assets below. The GitHub-generated source archives do not contain a compiled application.
- Unzip it and drag Codex Costs.app into Applications.
- Open the app. No Xcode, compiler, API key or local server is required.
Requirements: macOS 14 Sonoma or later. Universal binary for Apple Silicon and Intel Macs.
Signing: this build is locally ad-hoc signed and is not notarized by Apple. macOS may block the first launch. If you trust this source, follow Apple's instructions for opening an app from an unidentified developer: attempt to open it, then use System Settings → Privacy & Security → Open Anyway when offered.
Included
- English interface with date, time, conversation title, model and estimated token cost.
- Compact calendar with single-date and Shift-click range selection. Empty and future days are disabled.
- Clickable conversation IDs; Guardian review IDs remain plain text.
- Token and pricing details in an info panel.
- Live filesystem notifications and full rereads of changed logs only, with a 60-second recovery check.
- Current Standard API prices via tools.pwa.ovh, refreshed every six hours with a local fallback cache and retrieval date.
- Selected Code app icon.
Estimation and privacy
Logs stay on your Mac. The app reads ~/.codex/sessions and the local title index. Only the pricing endpoint is contacted; logs and conversation data are not uploaded.
Costs are API-equivalent token estimates, not ChatGPT subscription charges or historical invoices. Tools, subagents and surcharges are excluded. Multiple-model conversations, missing prices, incomplete counters and unknown cache-write retention have no estimate.
Context pricing uses the disclosed convention shown in the app: total per-request input includes cached tokens and selects rates for the whole request. These details remain unverified by the pricing endpoint.
The app lists conversations by their creation-day folder. Select an earlier date to follow a conversation created on that day.
Built from commit a82fa9a.