Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Codex Usage Widget

非官方 / Unofficial
Isaac 独立制作的非官方工具,与 OpenAI 不存在隶属、合作、赞助、认可、授权、背书或技术支持关系。显示数据仅供参考,额度、重置时间与 Credits 请以官方用量页为准。

仅二进制 / Binary only — not open source
本公开仓库仅提供官方下载和问题反馈,不提供应用源代码,也不属于开源软件。

中文

功能与要求

  • Windows 10/11 x64、.NET Framework 4.8;无需管理员权限。
  • 显示 5 小时和 7 天额度,以及重置倒计时。
  • 数据约每分钟自动刷新,也可手动刷新。
  • 支持折叠/展开、托盘、置顶、随 Windows 启动、仅背板透明度、跨显示器拖动,以及左侧、右侧和顶部边缘自动隐藏。

下载与运行

仅从 Releases 下载 UsageWidget-Windows-x64.exe,并先用同页的 SHA256SUMS.txt 核对 SHA-256。程序当前未进行 Authenticode 签名,Windows SmartScreen 可能显示未知发布者;不要关闭 Defender、SmartScreen 或其他安全软件。只有在下载来源和哈希都核对正确时,才自行决定是否运行。

实时数据通过本机 codex.exe app-server --stdio 获取;该本机 Codex 进程可能使用现有登录状态访问 OpenAI 服务。实时查询失败时,小工具可能读取 %LOCALAPPDATA%\CodexUsageWidget\config.json%USERPROFILE%\.codex\sessions 下近期 JSONL 文件尾部的额度事件,以及自身上次成功快照。session 行可能包含提示词或回复;小工具只提取额度字段,不会将对话正文写入自身快照。完整的数据来源、网络行为及本地存储说明见 PRIVACY.md

使用、退出与卸载

隐藏窗口并不等于退出程序。请通过托盘图标或窗口右键菜单选择退出。

手动卸载时,请先退出小工具并关闭“随 Windows 启动”,再删除下载的那个 UsageWidget-Windows-x64.exe 文件。如需清理本地数据,可分别删除:

  • %LOCALAPPDATA%\UsageWidget\last-successful-snapshot.json
  • %LOCALAPPDATA%\UsageWidget\usage.log
  • HKEY_CURRENT_USER\Software\UsageWidget
  • 可选的启动项值:HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run\UsageWidget

这些位置需要逐项手动处理;删除 EXE 不会自动删除快照、日志或界面设置。

已知限制

  • 仅支持 x64 Windows。
  • 实时数据需要本机已安装并登录 Codex。
  • 回退数据可能过期;倒计时依赖本地时区与系统时钟。
  • EXE 未签名,且没有自动更新。
  • 不提供额度预警功能;不同显示器组合下的实际体验可能不同。

许可、隐私与反馈

这是专有免费软件。个人和组织内部可免费使用未经修改的官方二进制,其他限制见 LICENSE.txt。隐私信息见 PRIVACY.md,安全问题仅按 SECURITY.md 的私密渠道报告。

请只在 CONTRIBUTING.md 规定的范围内提交 Issue。提交前必须删除账户资料、用户名、机器路径、提示词、回复、令牌及其他隐私内容;不要上传 session、认证文件、原始完整日志、二进制或含隐私信息的截图。

展开态示例

示例数据,不代表实时额度 / Example data only; not live usage.

折叠态示例

示例数据,不代表实时额度 / Example data only; not live usage.


English

Features and requirements

  • Windows 10/11 x64 and .NET Framework 4.8; administrator rights are not required.
  • Displays 5-hour and 7-day usage windows and their reset countdowns.
  • Refreshes data about once per minute and also supports manual refresh.
  • Supports fold/expand, a tray icon, topmost mode, start with Windows, background-only opacity, cross-monitor dragging, and left, right, and top-edge auto-hide.

Download and run

Download UsageWidget-Windows-x64.exe only from Releases, then verify it with the accompanying SHA256SUMS.txt. The program is not currently Authenticode-signed, so Windows SmartScreen may show an unknown publisher. Do not disable Defender, SmartScreen, or other security software. Decide whether to run it only after verifying both the download origin and hash.

Live data is read through the local codex.exe app-server --stdio process; that local Codex process may use the existing sign-in state to access OpenAI services. If live lookup fails, the widget may inspect %LOCALAPPDATA%\CodexUsageWidget\config.json, recent quota events in the tails of JSONL files under %USERPROFILE%\.codex\sessions, and its own last successful snapshot. Session lines can contain prompts or responses; the widget extracts quota fields only and does not write conversation bodies to its own snapshot. See PRIVACY.md for complete data-source, network, and local-storage details.

Use, exit, and uninstall

Hiding the window does not exit the program. Exit from the tray icon or the window context menu.

For manual uninstall, first exit the widget and turn off “start with Windows”, then delete the downloaded UsageWidget-Windows-x64.exe file. To clear local data, remove these individual items if wanted:

  • %LOCALAPPDATA%\UsageWidget\last-successful-snapshot.json
  • %LOCALAPPDATA%\UsageWidget\usage.log
  • HKEY_CURRENT_USER\Software\UsageWidget
  • Optional startup value: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run\UsageWidget

Handle each location individually. Deleting the EXE does not automatically remove snapshots, logs, or interface settings.

Known limits

  • x64 Windows only.
  • Live data requires Codex to be installed and signed in locally.
  • Fallback data can be stale; countdowns depend on the local timezone and system clock.
  • The EXE is unsigned and has no automatic updates.
  • There is no quota-alert feature; behavior can vary across monitor arrangements.

License, privacy, and feedback

This is proprietary freeware. Personal use and internal organizational use of unmodified official binaries are free; see LICENSE.txt for all restrictions. See PRIVACY.md for privacy information, and report security issues only through the private channel described in SECURITY.md.

Submit Issues only within the scope of CONTRIBUTING.md. Before submitting, remove account details, usernames, machine paths, prompts, responses, tokens, and other private material. Do not upload session files, authentication files, unredacted full logs, binaries, or screenshots containing private data.

Expanded example

示例数据,不代表实时额度 / Example data only; not live usage.

Folded example

示例数据,不代表实时额度 / Example data only; not live usage.

Copyright © 2026 Isaac. All rights reserved.

About

Unofficial Windows usage widget. Binary-only distribution.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors