# Set up Claw Light

> A desk light that shows what your Claude Code agents are doing.
> Green means working, red means one needs you.

**Reading this in your terminal, or handing it to your coding agent?** Perfect —
that's the whole idea. Everything below is copy-pasteable. You can even tell
Claude Code: *"Set up Claw Light using the instructions at
clawlight.dev/setup-for-agents."*

---

## 1. Install the ClawLight CLI

The CLI is the brain: a small Rust tool that watches your Claude Code sessions
and reports one honest status color.

```bash
brew install clawlight/tap/clawlight
```

Verify it:

```bash
clawlight --help
```

Register the Claude Code hooks and start the menu-bar daemon (it runs
automatically at login from here on):

```bash
clawlight install
```

Launching the dashboard (`clawlight`) also does this automatically on first
run, but `clawlight install` is the non-interactive way — the right choice
when an agent or script is doing the setup.

Prefer a prebuilt binary, or on Windows/Linux? See
https://clawlight.dev/docs/installation.

## 2. See your agents

Open the live dashboard:

```bash
clawlight
```

Every active Claude Code session shows up with a name and its current color, and
a single aggregate color lives in your menu bar / system tray.

## 3. Pair your Claw Light (the lamp)

If you have the hardware, plug it in over USB-C (retail units ship
pre-flashed), open the dashboard, and press `l` to enable status LEDs:

```bash
clawlight
```

The lamp now mirrors your aggregate status in real time — the daemon drives it
from then on, reconnecting automatically when you replug it. Press `l` again
to turn it off.

## Other agents

ClawLight supports opencode, Codex CLI, and GitHub Copilot CLI too. The same
`clawlight install` from step 1 sets up whichever of those it detects,
automatically, no extra commands needed. A few things to know:

- **opencode**: restart any session that was already running before you
  installed; it only loads plugins at startup.
- **Codex CLI**: needs Codex CLI 0.144 or newer, and approves itself: the
  first time, run `/hooks` inside Codex and approve the new entries.
- **GitHub Copilot CLI**: restart sessions that were already running, and
  note that a session only appears once you submit its first prompt (Copilot
  fires no event when its TUI opens).

Full per-agent details: https://clawlight.dev/docs/supported-agents

## What the colors mean

- 🟢 **Green** — agents are working
- 🟡 **Yellow** — idle / waiting
- 🔴 **Red** — a session needs your input
- ⚪ **Gray** — no live sessions

"Most urgent wins": if any session needs you, everything goes red.

## More

- Full docs: https://clawlight.dev/docs
- Install options: https://clawlight.dev/docs/installation
- Supported agents: https://clawlight.dev/docs/supported-agents
- The lamp: https://clawlight.dev/docs/claw-light
- Troubleshooting: https://clawlight.dev/docs/troubleshooting
- Open-source CLI: https://github.com/clawlight/clawlight-cli

Happy shipping. Watch the light. ●