{"id":50874027,"url":"https://github.com/whitewooood/codex-extra","last_synced_at":"2026-06-15T08:00:52.726Z","repository":{"id":364810488,"uuid":"1269292120","full_name":"whitewooood/codex-extra","owner":"whitewooood","description":"Menu bar monitor for Codex Desktop usage, task status, and local sound alerts","archived":false,"fork":false,"pushed_at":"2026-06-14T15:22:23.000Z","size":1850,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-14T16:47:25.836Z","etag":null,"topics":["codex","macos","menu-bar","menubar","swift","swiftui","token-usage"],"latest_commit_sha":null,"homepage":null,"language":"Swift","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/whitewooood.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-06-14T14:33:22.000Z","updated_at":"2026-06-14T15:22:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/whitewooood/codex-extra","commit_stats":null,"previous_names":["whitewooood/codex-extra"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/whitewooood/codex-extra","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whitewooood%2Fcodex-extra","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whitewooood%2Fcodex-extra/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whitewooood%2Fcodex-extra/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whitewooood%2Fcodex-extra/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whitewooood","download_url":"https://codeload.github.com/whitewooood/codex-extra/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whitewooood%2Fcodex-extra/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34353193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","macos","menu-bar","menubar","swift","swiftui","token-usage"],"created_at":"2026-06-15T08:00:24.457Z","updated_at":"2026-06-15T08:00:52.719Z","avatar_url":"https://github.com/whitewooood.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Codex Monitor\n\n[![Swift](https://github.com/whitewooood/codex-extra/actions/workflows/swift.yml/badge.svg)](https://github.com/whitewooood/codex-extra/actions/workflows/swift.yml)\n[![Release](https://img.shields.io/github/v/release/whitewooood/codex-extra?display_name=tag\u0026sort=semver)](https://github.com/whitewooood/codex-extra/releases)\n[![macOS 13+](https://img.shields.io/badge/macOS-13%2B-informational)](docs/INSTALL.md)\n[![License: MIT](https://img.shields.io/badge/License-MIT-informational.svg)](LICENSE)\n\n中文 | [English](#english)\n\nCodex Monitor 是一个 macOS 菜单栏工具，用来查看 Codex Desktop 的本地用量日志，并在任务完成或失败时播放提示音。\n\n它不是 OpenAI 或 Codex 官方项目。它只读取本机的 `~/.codex/sessions`，不上传日志，也不调用云端账单 API。\n\n\u003cimg src=\"docs/assets/screenshots/menu-panel.png\" alt=\"Codex Monitor menu panel\" width=\"520\"\u003e\n\n## 功能\n\n- 菜单栏显示 5 小时和 7 天用量窗口。\n- 下拉面板显示最近用量、累计用量、剩余额度、重置时间、24 小时趋势和最近 3 个会话排行。\n- Codex 任务完成时播放完成提示音；失败、受阻、超时或取消时播放失败提示音。\n- 可设置完成/失败声音、音量、安静时段、登录时启动和菜单栏显示模式。\n- 可选检查 GitHub Releases 更新；默认关闭，不会自动下载或安装。\n\n## 安装\n\n下载最新版：\n\n[GitHub Releases](https://github.com/whitewooood/codex-extra/releases/latest)\n\n推荐下载 `CodexMonitor-\u003cversion\u003e-macOS.dmg`，打开后把 `Codex Monitor.app` 拖到 Applications。也提供 zip 版本。\n\n当前 release 使用 ad-hoc 签名，尚未 notarized。macOS 可能提示无法验证开发者，处理方式见 [SIGNING.md](docs/SIGNING.md)。\n\n要求：\n\n- macOS 13 或更新版本。\n- 已运行过 Codex Desktop，并生成 `~/.codex/sessions` 日志。\n\n## 从源码运行\n\n需要 Xcode Command Line Tools。\n\n```bash\ngit clone https://github.com/whitewooood/codex-extra.git\ncd codex-extra\n./script/build_and_run.sh\n```\n\n安装到当前用户的 Applications 目录：\n\n```bash\n./script/build_and_run.sh --install\n```\n\n安装登录项：\n\n```bash\n./script/build_and_run.sh --install-login-item\n```\n\n移除登录项：\n\n```bash\n./script/build_and_run.sh --uninstall-login-item\n```\n\n更多安装细节见 [INSTALL.md](docs/INSTALL.md)。\n\n## 数据来源\n\nCodex Monitor 读取 Codex Desktop 本地 JSONL 日志里的 `token_count`、`task_complete` 等事件。\n\n目前会显示：\n\n- 最近一次 token 用量。\n- 当前会话累计 token。\n- 模型上下文窗口。\n- 5 小时和 7 天窗口的使用百分比及重置时间。\n\n这不是 Codex 官方稳定 API。如果 Codex Desktop 改变本地日志格式，本项目可能需要更新。\n\n## 隐私\n\n- 不上传 Codex 日志。\n- 不发送遥测。\n- 不调用云端账单或用量 API。\n- 不修改 Codex Desktop 设置。\n- 偏好设置保存在当前用户的 `UserDefaults`。\n- 自动检查更新默认关闭；开启后只请求 GitHub Releases latest API。\n\n详情见 [PRIVACY.md](docs/PRIVACY.md)。\n\n## 开发\n\n运行测试：\n\n```bash\nswift test\n```\n\n严格并发检查：\n\n```bash\nswift test -Xswiftc -strict-concurrency=complete -Xswiftc -warnings-as-errors\n```\n\n打包 release：\n\n```bash\nbash ./script/package_release.sh\n```\n\n相关文档：\n\n- [CONFIGURATION.md](docs/CONFIGURATION.md)\n- [RELEASING.md](docs/RELEASING.md)\n- [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## 许可证\n\nMIT. See [LICENSE](LICENSE).\n\n---\n\n## English\n\n[中文](#codex-monitor) | English\n\nCodex Monitor is a macOS menu bar app for local Codex Desktop usage logs. It shows the 5-hour and 7-day usage windows, and can play local sounds when a Codex task completes or fails.\n\nThis is not an official OpenAI or Codex project. It reads local `~/.codex/sessions` files only. It does not upload logs or call a cloud billing API.\n\n## Features\n\n- Menu bar usage meter for the 5-hour and 7-day windows.\n- Dropdown panel with recent tokens, total tokens, remaining usage, reset times, 24-hour trend, and top 3 recent sessions.\n- Local completion and failure sounds.\n- Preferences for custom sounds, volume, quiet hours, launch at login, and menu bar display mode.\n- Optional GitHub Releases update check, off by default.\n\n## Install\n\nDownload the latest release:\n\n[GitHub Releases](https://github.com/whitewooood/codex-extra/releases/latest)\n\nUse `CodexMonitor-\u003cversion\u003e-macOS.dmg` for normal installation. Open it and drag `Codex Monitor.app` to Applications. A zip archive is also available.\n\nRelease artifacts are ad-hoc signed and not notarized yet. See [SIGNING.md](docs/SIGNING.md).\n\nRequirements:\n\n- macOS 13 or newer.\n- Codex Desktop with local `~/.codex/sessions` logs.\n\n## Build From Source\n\n```bash\ngit clone https://github.com/whitewooood/codex-extra.git\ncd codex-extra\n./script/build_and_run.sh\n```\n\nRun tests:\n\n```bash\nswift test\n```\n\nBuild release artifacts:\n\n```bash\nbash ./script/package_release.sh\n```\n\n## Privacy\n\nLog parsing and sound playback are local. Codex Monitor does not upload Codex logs, send telemetry, call billing APIs, or modify Codex Desktop settings. See [PRIVACY.md](docs/PRIVACY.md).\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhitewooood%2Fcodex-extra","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhitewooood%2Fcodex-extra","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhitewooood%2Fcodex-extra/lists"}