Installing ClawLight CLI

The ClawLight CLI is written in Rust and runs on macOS, Windows, and Linux. Pick whichever install method you prefer.

Heads up

The exact formula name and release assets are maintained in the ClawLight CLI repository. If a command below has drifted, the repo README is the source of truth.

Windows — one step

Paste this into PowerShell:

irm https://clawlight.dev/install.ps1 | iex

That's the whole install. The script downloads the latest Windows release, verifies its checksum, installs it to %LOCALAPPDATA%\Programs\clawlight, adds it to your PATH, and sets up every coding agent it detects along with the tray daemon. The tray icon appears right away. You're done.

Using WSL?

Still run the one-liner above in Windows PowerShell, not Homebrew inside WSL. Homebrew in WSL installs a Linux binary that can't show a Windows tray icon or reach the lamp over USB serial. The native Windows daemon handles all of that, and thanks to WSL interop you can still open the dashboard from a WSL shell by running clawlight.exe.

macOS & Linux — Homebrew (recommended)

brew install clawlight/tap/clawlight

Prebuilt binary

Download the latest archive for your architecture from the GitHub Releases page, then move the binary onto your PATH:

tar -xzf clawlight-*.tar.gz
sudo mv clawlight /usr/local/bin/

(Windows archives are named clawlight-v*-x86_64-pc-windows-msvc.tar.gz — the one-step script above does this for you.)

Set up

Installed with the Windows one-step script? Setup already ran — skip to the next page. Everyone else: just launch the dashboard. The first time you run it, ClawLight sets up every coding agent it detects and starts the menu-bar daemon (set to run automatically at login) for you:

clawlight

Prefer to wire everything up without opening the dashboard — in a script, or over SSH? Run the setup explicitly instead:

clawlight install

Either way the menu-bar icon appears right away and the hooks are active for every agent ClawLight found:

Claude Code: hooks in ~/.claude/settings.json, the default flow
opencode: a plugin at ~/.config/opencode/plugins/clawlight.js; restart sessions that were already running to pick it up
Codex CLI: hook entries in $CODEX_HOME/hooks.json (needs Codex CLI 0.144+ and a one-time /hooks approval inside Codex)
GitHub Copilot CLI: a wholly-owned ~/.copilot/hooks/clawlight.json; restart sessions that were already running, and a session only appears once you submit its first prompt

See supported agents → for full per-agent details.

Set up your Claw Light (optional)

Drag to rotate — the lens shows the live session color.

Have the lamp? Plug it in over USB-C, then open the dashboard:

clawlight

Then press l to turn on the status LEDs. The lamp mirrors your aggregate session color from then on. The menu-bar daemon drives it, reconnecting automatically whenever you replug it. Press l again to turn it off.

Want the full hardware walkthrough?

Flashing firmware, pinning a serial port, and pushing updates over USB all live in The Claw Light →.

Next: using ClawLight CLI →