From e13880480330fc7421fd1b06a5669b118c59f2bb Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Mon, 16 Nov 2026 13:05:12 +0100 Subject: Initial commit: agent-lamp agent notification light agent-lamp drives an IKEA TRADFRI colour bulb as a notification light for coding agents, Claude Code and opencode. This commit holds the approved design spec, the repo docs and the GPLv2 license; the script itself follows. Co-Authored-By: Claude Opus 5.5 --- README.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..3d90699 --- /dev/null +++ b/README.md @@ -0,0 +1,36 @@ +# 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 + +## 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. -- cgit v1.2.3