A small dashboard for Claude Code status and token use
codelight is an open-source tool for watching the status and token use of such as Claude Code. A runs on the computer, checks Claude Code usage and status, and sends that information to a desk screen, an , a GNOME panel, or the VSCode status area.
With turned on, can be allowed or denied from Android or GNOME, and questions can be answered from Android, GNOME, or VSCode. If several devices can answer, the first answer received is used.
If no suitable device is connected, Claude Code’s normal prompt appears right away, so the work is not left waiting on a missing device. Setup starts by flashing the screen firmware, running `python3 companion/codelight.py --name my-laptop`, and adding `--secret` plus `--remote-control` when remote approval and answers are needed.
Key points
- Claude Code working, waiting, and input-needed states can be shown outside the main terminal.
- Token use can be monitored from a desk screen, phone widget, GNOME panel, or VSCode.
- can be approved or denied from Android or GNOME.
- Questions can be answered from Android, GNOME, or VSCode.
- requires `--secret` and `--remote-control` to be enabled.