Developer tooling · Local-first visibility
Codex Usage
Local developer-tooling visibility without a cloud dashboard.
A Quickshell module that combines local Codex session totals with live, cached, stale, or local-only rate-limit state in one compact interface.
01
The state problem
Useful usage data arrives from different local sources and at different freshness levels. A single number without source state can look more authoritative than it is.
02
System shape
- Local session metadata
- Optional live limit snapshot
- Collector
- Cache and freshness state
- QML service
- Bar indicator and detail panel
03
Key engineering decisions
Expose freshness
The interface distinguishes live, cached, stale, and local-only states.
Degrade gracefully
Cached and local session metadata remain useful when the live source is unavailable.
Keep workspace collection opt-in
Workspace names are not collected by default.
Respect disabled state
The collector pauses when the module is disabled.
Follow the desktop environment
Theme-aware UI and configurable palettes integrate with the existing Quickshell surface.
04
Result and evidence
A publicly inspectable, installable module with explicit privacy controls, source-state feedback, and documented fallback behavior.
Public evidence
05
Scope boundaries
- This is an independent module, not an official OpenAI integration.
- Real token totals, reset times, workspace names, account identifiers, and local paths are not shown here.
- The visual on this page is a documented state model, not a product screenshot.