Claude Codex Usage Companion

Claude Codex Usage Companion is an open-source app that shows the usage limits (the 5-hour and weekly windows) of Claude Code, Codex and Google Antigravity in one always-on-top panel on the Linux desktop, with a CLI and a tray icon. The original is gkfriend’s Windows (WPF) app, which ychsieh95 ported to Linux with Avalonia. I forked from version 0.1.2 and added Antigravity as a third provider, built a GNOME top-bar extension, a usage history and analysis suite, a light theme, a compact mode and more translations — my work lives on the feature/antigravity branch.

1. 01AI coding tools have two overlapping limits (5-hour and weekly); if you don’t look, you only find out when you’ve run out.
2. 02Each provider shows its quota in a different place and format, and Antigravity has no public API for it.
3. 03The existing app showed the current state and could log it to a file, but had no history view, so it couldn’t say how fast you burn quota or whether a cycle was used well before it reset.
4. 04Linux means several desktops and window systems (KDE/GNOME, X11/Wayland) that handle status bars and floating windows differently.

1. 01Antigravity: find the running language-server process through /proc (the user’s own only), read its port and CSRF token, and call its local service over loopback for a quota summary — mapped to two shared pools (Gemini, and Claude + ChatGPT) without storing the token or sending anything off the machine.
2. 02Interface: Claude → Codex → Antigravity cards with a countdown to the reset, compact mode, light/dark themes and a categorised settings window with search.
3. 03A GNOME top-bar extension (GJS) that receives state from the app through a state bridge, with an install script that clears stale versions and JS tests.
4. 04Usage history: reads the CSV the app logs (old and new schemas), draws the remaining-quota trend, offers 24H/7D/30D/All ranges and provider filters, and marks detected resets with orange dashed lines.
5. 05Analysis: hourly burn rate, the 5-hour to weekly quota ratio, a runway status and a Reset efficiency window — counting only downward quota movement, never the recovery at a reset.
6. 06The new screens translated into three languages (English, 繁體中文, 简体中文), plus desktop integration tests in CI (GNOME extension, Plasma widget, installer).

1. 01Three providers’ quotas, with history and analysis, in one app instead of several places.
2. 02Test methods grew from 169 to 303, and CI runs Debug and Release with warnings treated as errors.
3. 03The screens state their own limits, e.g. “estimated from local samples” and “activity between refreshes may not be captured”.

• Antigravity provider (process discovery, client, parser, runtime provider) with tests
• GNOME top-bar extension and its install script
• History, analysis, Reset efficiency and Timeline windows
• Light theme, compact mode and a redesigned settings window
• install-desktop.sh and desktop integration tests in CI

• C#
• .NET 10
• Avalonia
• xUnit
• GJS (GNOME Shell)
• Tmds.DBus
• GitHub Actions
• Bash

• Linux port upstream (ychsieh95)
• Original Windows app (gkfriend)

• 2026Catadex — A Directory of Specialist Catalogs1,248 specialist data catalogs in 34 fields, explored through cards, a relationship graph and guided trails, and searchable in Thai and EnglishPersonal
• 2026graph.phatphum.me — Visual Knowledge AtlasOne knowledge model, several ways to read it: a dependency graph, a roadmap, an outline and a focus view — with Frontend, Computer Networks and Cybersecurity curricula I wrote and validated myselfPersonal
• 2026BookNest — A Personal Library with Book Knowledge MapsA local-first library of books and magazine issues that keeps each book’s real table of contents, terms, diagrams and reading paths as validated JSON — no account or cloudPersonal