Agent Fuel Dial

The Story

Codex and Claude Code are useful coding partners, but their usage limits are difficult to check at a glance. I wanted a small device that could show the remaining capacity without interrupting my work or opening another terminal.

That idea became Agent Fuel Dial, an M5Stack M5Dial dashboard that treats AI usage limits like fuel gauges.

The 240 × 240 circular display shows Codex and Claude Code rate-limit windows, including weekly and five-hour limits when available. A Combined screen places both providers on mirrored gauges, surrounded by an animated ring, with the local date and time in the center.

The rotary dial changes screens. A short press switches between used and remaining percentages, a long press opens settings, and a double click refreshes the data.

How it works

The M5Dial does not access provider APIs or store OAuth credentials directly. Instead, a Python bridge runs on a PC connected to the same trusted LAN.

Codex and Claude credentials
            ↓
      PC-side bridge
            ↓
     Normalized JSON
            ↓
          M5Dial

The bridge reads the existing local Codex CLI and Claude Code authentication files, retrieves usage information, and converts it into a common format. Only values such as remaining percentage, reset time, and connection status are sent to the device. Provider credentials stay on the PC.

When an upstream service does not provide a usage window, the display shows _% and NO DATA instead of treating it as zero usage or an authentication error.

This project is currently a personal-use proof of concept. The bridge is designed for a trusted home or office LAN and should not be exposed directly to the Internet.

Agent Fuel Dial turns otherwise hidden AI usage limits into a physical instrument that can remain visible beside the keyboard while I work.