Claw Light: see your agents at a glance

What clawlight install sets up for Claude Code, opencode, Codex CLI, and GitHub Copilot CLI, and what each adapter's quirks are.

ClawLight watches Claude Code, opencode, Codex CLI, and GitHub Copilot CLI sessions from one clawlight install. Claude Code is the default flow, the only one with auto-generated session names. The same install sets up opencode, Codex CLI, and GitHub Copilot CLI automatically, whichever it finds, so every agent you run lights up the same TUI, tray icon, and lamp.

clawlight install

detects each agent independently and wires up hooks only for the ones present. clawlight uninstall reverses cleanly, and ClawLight never touches another tool's own configuration: each adapter either merges into the agent's native hook mechanism (Claude Code, Codex CLI) or writes a file it wholly owns and can prove it owns (opencode's plugin, Copilot's hooks file).

Badge legend

Sessions from agents other than Claude Code carry a small badge in the TUI table and tray popover so you can tell them apart at a glance:

Badge	Agent
(none)	Claude Code
`oc`	opencode
`cx`	Codex CLI
`co`	GitHub Copilot CLI

All four share the same four status colors and the same "most urgent wins" aggregate. See the colors.

Claude Code

The default flow, with no extra setup or quirks. clawlight install registers hooks in ~/.claude/settings.json. Sessions are auto-named via the claude CLI itself, a Claude-only feature the other adapters can't match.

opencode

clawlight install writes a plugin to ~/.config/opencode/plugins/clawlight.js.

Restart running sessions

opencode only loads plugins at startup, so any session already running when you install won't pick up the plugin. Restart it to see it in ClawLight.

Codex CLI

clawlight install adds hook entries to $CODEX_HOME/hooks.json (default ~/.codex).

Requirements

Needs Codex CLI 0.144 or newer. The first time, Codex will ask you to approve the new hook entries yourself: run /hooks inside Codex and approve them once.

Usage/spend tracking (opt-in, in the tray popover's Settings) covers Claude Code and Codex CLI only, not opencode or Copilot.

GitHub Copilot CLI

clawlight install writes a file it wholly owns, ~/.copilot/hooks/clawlight.json. It never merges into any other Copilot configuration.

Restart running sessions

Sessions already open when you install need a restart to appear.

Sessions appear on your first prompt, not on launch

Copilot fires no lifecycle event when its TUI opens, so ClawLight only sees a session once you submit the first prompt. That's expected, not a bug. Copilot's own footer showing Loading: 7 hooks is also normal: it's just Copilot's resource ticker, not an error.

What uninstall removes

clawlight uninstall

removes exactly what install added, per agent: the Claude Code hook entries, the opencode plugin (only if it still carries clawlight's managed-by marker), the Codex CLI hook entries, and the wholly-owned Copilot hooks/clawlight.json. Nothing else in any agent's configuration is ever touched.

Next: set up your Claw Light →

Supported agents