whatisgithub

What is claude-codex-usage-dashboard?

frankchiu-dev/claude-codex-usage-dashboard — explained in plain English

Analysis updated 2026-05-18

166JavaScriptAudience · developerComplexity · 2/5LicenseSetup · moderate

In one sentence

A local dashboard, viewable from your phone or tablet over Wi-Fi, that shows how much of your Claude Code and Codex AI usage limits you have used.

Mindmap

mindmap
  root((usage dashboard))
    What it does
      Shows Claude usage
      Shows Codex usage
      Red alert threshold
      KOBO e-ink mode
    Tech stack
      JavaScript
      Node.js
      No npm deps
    Use cases
      Phone tablet monitoring
      Old e-ink devices
      Fanout with other tools
    Requirements
      Node 18 plus
      Local Claude Codex data
      Same Wi-Fi network

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check remaining Claude Code and Codex usage quota from a phone or tablet without opening a laptop.

USE CASE 2

Get an at-a-glance alert when AI coding tool usage is close to its limit for the current window.

USE CASE 3

Repurpose an old e-ink device like a KOBO reader as a low-distraction usage monitor.

What is it built with?

JavaScriptNode.js

How does it compare?

frankchiu-dev/claude-codex-usage-dashboardtasihi89/canvas-handdexzane/awesome-web-prompts
Stars166165170
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasyeasy
Complexity2/52/51/5
Audiencedevelopervibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 18+ and locally configured Claude Code statusLine or Codex session data to show real numbers.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

This project is an unofficial local dashboard that shows how much of your Claude Code and Codex usage limits you have used, displayed on a spare phone, tablet, or small screen. It is meant for people who already use these AI coding tools regularly and want an easy way to keep an eye on their remaining quota without opening a laptop. A small server runs on your own Windows or macOS computer, reads usage information that is already stored locally by Claude Code and Codex, and serves a simple web page that other devices on the same Wi-Fi network can open in a browser. It shows both the 5 hour and weekly usage windows, can display either how much you have used or how much you have left, and turns red once usage crosses a chosen alert threshold. The dashboard also includes a version built for older e-ink screens like a KOBO reader, since those browsers often cannot handle modern web features. Setup involves cloning the project and running it with Node.js, which is the only requirement beyond having Claude Code or Codex already installed and generating their own local usage records. Helper scripts are included for both Windows and macOS to start the dashboard, configure Claude Code to feed it usage data, and optionally set the dashboard to start automatically when you log in. If you already use another tool that reads Claude Code's status line, the project includes a fanout mode so both tools can receive the same data at once. The numbers only update after you actually use Claude Code or Codex, since the dashboard depends on the same local files those tools already write, and opening Claude in a web or desktop app rather than the CLI will not update it. All data stays on your own machine and nothing is uploaded anywhere. The project is not affiliated with Anthropic or OpenAI and is described by its author as a personal side project with best effort support. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up claude-codex-usage-dashboard on Windows and configure the Claude Code statusLine so it reports real usage.
Prompt 2
How do I run claude-codex-usage-dashboard so a tablet on the same Wi-Fi network can view it?
Prompt 3
Explain how to enable fanout mode in claude-codex-usage-dashboard if I already have a custom statusLine script.
Prompt 4
Show me how to change the alert threshold and display mode using environment variables for claude-codex-usage-dashboard.

Frequently asked questions

What is claude-codex-usage-dashboard?

A local dashboard, viewable from your phone or tablet over Wi-Fi, that shows how much of your Claude Code and Codex AI usage limits you have used.

What language is claude-codex-usage-dashboard written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js.

What license does claude-codex-usage-dashboard use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claude-codex-usage-dashboard to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-codex-usage-dashboard for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.