Skip to content

Codex Costs v1.0.0

Choose a tag to compare

@GabrielDelepine GabrielDelepine released this 22 Oct 11:51
· 55 commits to main since this release
a82fa9a

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

  1. Download Codex-Costs-v1.0.0-macOS-universal.zip from the assets below. The GitHub-generated source archives do not contain a compiled application.
  2. Unzip it and drag Codex Costs.app into Applications.
  3. 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.