ericjypark/codex-island

解决的问题

CodexIsland 是一个原生的 macOS 覆盖层，让用户能实时追踪 Claude Code 和 Codex 的 AI 使用限制。它解决了需要手动检查不同供应商配额的问题，将这些指标直接整合到 MacBook 的刘海（或菜单栏）中，实现持续且低干扰的监控。

运作方式

此应用程序作为一个本地优先的覆盖层运作。它会读取来自 Claude Code 和 Codex 命令行工具（例如 ~/.codex/auth.json 或 macOS Keychain）的现有验证凭证，并调用供应商的 API 端点。它本身不会存储凭证，但会维护一个本地的 SQLite 数据库来追踪 Token 数量与使用历史。

目标用户

Claude Code 和 Codex 的开发者与进阶用户，他们希望监控 5 小时与每周的使用窗口、根据本地日志估算 API 成本，并在 macOS 上可视化长期的 AI 使用模式。

特色亮点

• 刘海原生设计：类似 Dynamic Island 的覆盖层，完美契合硬件刘海，并为无刘海屏幕提供备用方案。
• 多供应商追踪：监控 Claude 与 Codex 在 5 小时与 7 天窗口内的使用情况。
• 成本估算：使用来自 Claude Code、Codex CLI 和 OpenCode 的本地会话日志，计算预估支出与 Token 吞吐量。
• 使用可视化：包含年度活动的贡献风格日历，以及带有累积图表的分享用使用卡片。
• 隐私导向：无遥测、无崩溃报告、无代理服务；所有聚合与渲染皆在设备端完成。
• 自定义警示：可选的警告与临界值设置，当接近限制时会改变岛屿的颜色。