{"id":47620238,"url":"https://github.com/xbotter/codex-cost","last_synced_at":"2026-04-01T22:00:46.644Z","repository":{"id":345033386,"uuid":"1184113227","full_name":"xbotter/codex-cost","owner":"xbotter","description":"A cross-platform menu bar app that estimates daily Codex usage cost from local session logs.","archived":false,"fork":false,"pushed_at":"2026-03-17T16:23:02.000Z","size":3805,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-18T01:09:08.057Z","etag":null,"topics":["codex","cost-tracking","macos","menubar-app","openai","rust","tauri","tray-app","typescript","usage-analytics"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xbotter.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-17T09:09:24.000Z","updated_at":"2026-03-17T16:23:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xbotter/codex-cost","commit_stats":null,"previous_names":["xbotter/codex-cost"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/xbotter/codex-cost","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xbotter%2Fcodex-cost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xbotter%2Fcodex-cost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xbotter%2Fcodex-cost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xbotter%2Fcodex-cost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xbotter","download_url":"https://codeload.github.com/xbotter/codex-cost/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xbotter%2Fcodex-cost/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292631,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["codex","cost-tracking","macos","menubar-app","openai","rust","tauri","tray-app","typescript","usage-analytics"],"created_at":"2026-04-01T22:00:24.090Z","updated_at":"2026-04-01T22:00:46.530Z","avatar_url":"https://github.com/xbotter.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"artifacts/branding/codex-cost-logo-mark.png\" alt=\"codex-cost logo\" width=\"160\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003ecodex-cost\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003eA lightweight desktop tray app for Codex users who want today's cost visible at a glance.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/xbotter/codex-cost/releases\"\u003e\n    \u003cimg alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/xbotter/codex-cost?style=flat-square\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\n    \u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/xbotter/codex-cost?style=flat-square\" /\u003e\n  \u003c/a\u003e\n  \u003cimg alt=\"Tauri v2\" src=\"https://img.shields.io/badge/Tauri-v2-24C8DB?style=flat-square\u0026logo=tauri\u0026logoColor=white\" /\u003e\n  \u003cimg alt=\"Rust\" src=\"https://img.shields.io/badge/Rust-stable-000000?style=flat-square\u0026logo=rust\" /\u003e\n  \u003cimg alt=\"TypeScript\" src=\"https://img.shields.io/badge/TypeScript-5.x-3178C6?style=flat-square\u0026logo=typescript\u0026logoColor=white\" /\u003e\n  \u003cimg alt=\"macOS\" src=\"https://img.shields.io/badge/macOS-supported-111827?style=flat-square\u0026logo=apple\" /\u003e\n  \u003cimg alt=\"Windows\" src=\"https://img.shields.io/badge/Windows-supported-0F6CBD?style=flat-square\u0026logo=windows\" /\u003e\n  \u003cimg alt=\"Linux\" src=\"https://img.shields.io/badge/Linux-supported-FCC624?style=flat-square\u0026logo=linux\u0026logoColor=111827\" /\u003e\n\u003c/p\u003e\n\n`codex-cost` is a lightweight desktop tray app for Codex users who want to keep today's cost visible at a glance.\n\nIt reads local Codex usage logs, estimates the current day's USD cost, and keeps that number close at hand through a tray icon, tooltip, and compact dashboard.\n\n![codex-cost dashboard](docs/dashboard-screenshot.png)\n\n## Highlights\n\n- Always-on tray app for Windows, macOS, and Linux\n- Reads local Codex logs directly\n- Tracks daily usage in local timezone\n- Includes subagent usage\n- Uses online LiteLLM pricing with local cache fallback\n- Provides a quiet dashboard for cost and token breakdown\n\n## What It Feels Like\n\n`codex-cost` is designed to stay out of the way.\n\n- Live in the tray instead of a terminal tab\n- Check today's value in one glance\n- Open a compact dashboard only when you need detail\n- Close the window without quitting the app\n\n## Installation\n\nDownload from GitHub Releases:\n\n- Latest release page: [github.com/xbotter/codex-cost/releases/latest](https://github.com/xbotter/codex-cost/releases/latest)\n\nPlatform notes:\n\n- macOS Apple Silicon: download the `aarch64` `.dmg`\n- macOS Intel: download the `x64` `.dmg`\n- Windows: download the NSIS installer\n- Linux: choose `AppImage` for a portable build or `deb` for Debian/Ubuntu-based systems\n\nWindows builds are distributed as an NSIS installer. The installer also places `WebView2Loader.dll` next to the app binary to avoid missing-loader startup failures.\n\n## How It Works\n\n`codex-cost` reads local Codex session JSONL logs and calculates usage from session deltas instead of summing raw cumulative counters.\n\nThe current implementation:\n\n- groups usage by local day\n- treats billable input as `input_tokens - cached_input_tokens`\n- includes `reasoning_output_tokens` in output cost\n- preserves cross-day session baselines to avoid overcounting\n\n## Acknowledgements\n\nThis project is inspired by [`ccusage`](https://github.com/ryoppippi/ccusage).\n\nIts Codex pricing and accounting behavior were an important reference while validating the usage model in `codex-cost`. This project takes that accounting direction and turns it into a desktop tray experience focused on always-on visibility.\n\n## Development\n\nRequirements:\n\n- Node.js 20+\n- Rust stable\n- Tauri v2 prerequisites for your platform\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nRun local checks:\n\n```bash\nnpm run check\n```\n\nRun in development:\n\n```bash\nnpm run tauri dev\n```\n\nBuild release artifacts locally:\n\n```bash\nnpm run build\nnpx tauri build\n```\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxbotter%2Fcodex-cost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxbotter%2Fcodex-cost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxbotter%2Fcodex-cost/lists"}