Codex Analytics Ledger

Codex Analytics Ledger is a privacy-first, local-only dashboard designed to provide insights into your usage of Codex. It meticulously tracks threads, model usage, runtime, token consumption, and offers API-equivalent cost estimations with task-level details. The primary goal is to allow users to understand their Codex expenditure without sending any data externally. The application reads Codex state directly from the local machine, ensuring no prompts or content are transmitted to any analytics service. It also includes scripts to disable Next.js telemetry and bind the server to localhost for enhanced privacy.

Key Features:

• Tracks threads across local Codex projects.
• Analyzes model and reasoning effort per thread and task.
• Displays last-updated time, active duration, and wall-clock duration.
• Reports input, cached-input, output, reasoning-output, and total tokens.
• Provides API-equivalent cost estimates with editable local pricing.
• Shows per-task user input, model, runtime, tokens, and estimated cost.
• Counts prompts, tool calls, shell commands, and web calls.
• Offers flat or collapsible project-grouped views.
• Supports sorting by recent, cost, token, and runtime.
• Includes light and dark themes with saved preferences.
• Aggregates model performance metrics.

The project emphasizes a strong privacy and security model, operating entirely locally. It uses read-only access to SQLite databases and avoids writing to Codex state or session files. Standard scripts are configured to listen only on 127.0.0.1 and disable telemetry. There are no external SDKs, hosted databases, or API key requirements.

Requirements:

• Node.js 24 or newer.
• A local Codex installation with a readable CODEX_HOME directory.
• Compatibility with Windows, macOS, or Linux.