Ark310

Codex Usage Tray — Development skill for Claude Code

Development community

Windows tray monitor for OpenAI Codex subscription limits (five-hour and weekly windows, resets, plan, credits), read live from the Codex app-server JSON-RPC.

How to install Codex Usage Tray

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Ark310/codex-usage-tray and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Codex Usage Tray does

Windows tray monitor for OpenAI Codex subscription limits (five-hour and weekly windows, resets, plan, credits), read live from the Codex app-server JSON-RPC. A port built on jens-duttke/usage-monitor-for-claude, with login/CLI diagnostics and a portable no-console build.

Alternatives in Development

Android Rpc — Android Debug RPC 1.3k ★
Dario — A local OpenAI- and Anthropic-compatible proxy that brings your Claude Pro/Max subscription to Cursor, Cline 485 ★
Backlinks — Check backlink credits and targets, and explain how the exchange works 195 ★

README

Codex Usage Tray

*Repository `codex-usage-tray`. Inside the code and build scripts the app keeps its original name, **Usage Monitor for Codex**.*

🍴 **Fork of [jens-duttke/usage-monitor-for-claude](https://github.com/jens-duttke/usage-monitor-for-claude) by Jens Duttke (MIT).** Forked at upstream `8cfac62` (v1.15.1, 2026-05-17). Upstream history and authorship are preserved, and the original Claude app is still in this tree, unchanged.

A Windows tray app that shows your **OpenAI Codex subscription limits** (five-hour and weekly windows, reset times, plan and credits) using the same lightweight tray icon and popup as Usage Monitor for Claude. It reads live quota over Codex's local `app-server` JSON-RPC interface.

![Python](https://img.shields.io/badge/Python-3.12-blue?logo=python&logoColor=white) ![pystray](https://img.shields.io/badge/tray-pystray-informational) ![pywebview](https://img.shields.io/badge/popup-pywebview-informational) ![Codex](https://img.shields.io/badge/data-codex%20app--server%20JSON--RPC-412991?logo=openai) ![cx_Freeze](https://img.shields.io/badge/build-cx__Freeze%20%7C%20PyInstaller-yellow) ![Tests](https://img.shields.io/badge/tests-791%20passing-brightgreen) ![License](https://img.shields.io/badge/license-MIT-green) ![Built with Codex](https://img.shields.io/badge/Built%20with-Codex-412991?logo=openai)

🧭 Part of **Abdul Raqeeb Khatri's portfolio**: [📂 Hub](https://github.com/Ark310/portfolio) · [🌐 Site](https://ark310.github.io) · [💼 Experience](https://github.com/Ark310/experience)

Overview

I relied on the upstream *Usage Monitor for Claude* tray app to keep an eye on Claude limits, and wanted the same glanceable tray icon for **Codex**. The Claude app gets its numbers from Anthropic's OAuth usage endpoint. Codex has no equivalent public endpoint, but the Codex CLI ships a local JSON-RPC server (`codex app-server --stdio`) that exposes `account/read` and `accou