Introduction
Claw Light + ClawLight CLI, see your Claude Code, opencode, Codex CLI, and GitHub Copilot CLI sessions at a glance.
Claw Light is a desktop status light that mirrors your Claude Code, opencode, Codex CLI, and GitHub Copilot CLI sessions in real time. It's the hardware companion to ClawLight CLI, a lightweight Rust tool that watches your sessions and reports a single, honest status color. See supported agents for what each agent needs.
Green means your agents are working. Red means one needs you. You'll know without alt-tabbing.
How the pieces fit
ClawLight CLI (the brain)
A TUI dashboard and macOS menu-bar daemon that watches every Claude Code session and computes an aggregate status.
Claw Light (the lamp)
An ESP32-powered LED on your desk that glows the current status color, driven by the ClawLight CLI.
The status colors
| Color | Meaning |
|---|---|
| 🟢 Green | All sessions active — agents are working. |
| 🟡 Yellow | Idle / waiting — nothing is actively running. |
| 🔴 Red | A session needs your input. |
| ⚪ Gray | No live sessions. |
Sessions from opencode, Codex CLI, and GitHub Copilot CLI carry a small badge
(oc / cx / co) in the TUI and tray popover so you can tell them apart.
See supported agents for the full legend.