lmtop

lmtop is a terminal dashboard tool, similar in spirit to the classic Unix tool top, but built specifically for tracking how much of your AI coding subscription capacity you have used up. It is aimed at people on flat-rate subscription plans for tools like OpenAI's Codex or Claude Code, rather than people paying per API call, and answers a specific question those tools do not: how much of my quota is left, when does it reset, how fast am I burning through it, and am I likely to run out before the reset happens.

The tool keeps three kinds of information strictly separate: locally observed token usage read from your own agent session files, the official quota percentages reported directly by the provider, and a note that estimated dollar cost is intentionally not calculated, since flat-rate plans apply hidden weighting that makes a real cost estimate misleading. On top of the provider's reported quota trend, it calculates how fast that quota is being consumed per hour and projects whether the current quota window will last until its reset time or run out first.

It supports both OpenAI Codex and Claude Code, showing local token usage, active sessions, weekly usage broken down by model, and reset countdown timers for each. A live mode can optionally check the same usage endpoints the providers' own official tools use, using the access token those tools already store locally, while an offline mode ensures no network requests happen at all.

Installation options include Homebrew on macOS and Linux, an apt repository for Debian and Ubuntu, downloading a pre-built binary for your platform, or building it from source using Rust's cargo tool. Once installed, it can run as a full interactive dashboard, print a one-shot text or JSON summary, or output a single line suitable for embedding in a terminal status bar like tmux.