Claude Codex Usage Dashboard

Claude / Codex Usage Dashboard

View Claude Code and Codex usage on your computer, phone, tablet, or KOBO. The dashboard runs on your own Windows or macOS computer. Cloudflare, a domain name, and a hosted server are optional.

Start on this computer

Install Node.js 18 or newer, then run:

Open http://127.0.0.1:8787. No npm install is required. Windows users can double-click start-dashboard.bat; macOS users can run bash start-dashboard.sh or the executable start-dashboard.command.

You can use Claude Code, Codex, or both. Missing data shows setup guidance; it is never treated as zero usage. This unofficial project is not affiliated with Anthropic or OpenAI.

View on a phone or tablet

1. Connect the computer and phone to the same trusted Wi-Fi network.
2. Stop the dashboard with Ctrl+C and start LAN mode:

3. Open the Pair link printed in the computer's terminal.
4. Choose Connect a device and scan the QR code for your Wi-Fi/Ethernet address.

The QR code is generated locally. Scanning it pairs the browser and opens the dashboard. Network mode requires pairing for the overview, usage API, history, and KOBO pages. Keep the QR code and pairing link private: they grant access to your usage. With the default temporary key, restarting signs devices out. An optional persistent key is described below.

If multiple network adapters are listed, choose the address belonging to the Wi-Fi or Ethernet connection shared with your phone. Guest Wi-Fi, client isolation, a VPN, or the computer's firewall may prevent a connection. Any firewall permission should be limited to your trusted private network.

The source computer must stay awake and the dashboard must keep running. LAN sharing uses HTTP; pairing does not encrypt Wi-Fi traffic. Use the optional HTTPS remote-access methods for…