# agent-lamp Turns an IKEA TRADFRI colour bulb into a notification light for coding agents. Purple means an agent waits for a permission, amber that it has a question, red that it failed, green that it finished. A request left waiting starts to breathe, and several agents needing different things cycle softly through their colours. When you answer, the bulb goes back to how it was. ## Requirements - Python 3 - libcoap's `coap-client` - An IKEA TRADFRI gateway with at least one colour bulb ## Install ln -s "$PWD/agent-lamp" ~/bin/agent-lamp agent-lamp --pair ## Usage agent-lamp permission | question | error | complete | clear agent-lamp claude read a Claude Code hook payload on stdin agent-lamp reset clear everything, restore the bulb agent-lamp --pair HOST CODE pair with the gateway agent-lamp --selftest ## Wiring - Claude Code: async hooks running `agent-lamp claude` on Notification, PreToolUse (matcher `AskUserQuestion`), PostToolUse, Stop, StopFailure, UserPromptSubmit and SessionEnd. - opencode: `@mohak34/opencode-notifier` with `"command": {"path": "notify-sound", "args": ["{event}", "{sessionID}"]}`; quickshell's `notify-sound` forwards both arguments to `agent-lamp`. - `agent-lamp reset` at logout, suspend and poweroff. - `$XDG_RUNTIME_DIR/status.nolamp` holding `1` keeps the bulb dark. ## License Copyright (C) 2026 Danilo M. GPLv2 only. See [LICENSE](LICENSE) for the full text. ## Development Approach This project is developed using AI-assisted tools. Code is generated with the help of AI based on human-provided specifications, design decisions, and iterative feedback. All contributions are reviewed, tested, and curated by the maintainer before being included in the codebase. AI is used as a productivity and exploration tool, while human oversight remains central to all decisions. The goal is to combine the flexibility of AI-assisted development with standard open-source practices such as transparency, review, and accountability.