aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-11-16 13:05:12 +0100
committerDanilo M. <danix@danix.xyz>2026-11-16 13:05:12 +0100
commite13880480330fc7421fd1b06a5669b118c59f2bb (patch)
tree647e7d64d307363d4c3c326c667d16a891eed3ee /README.md
downloadagent-lamp-e13880480330fc7421fd1b06a5669b118c59f2bb.tar.gz
agent-lamp-e13880480330fc7421fd1b06a5669b118c59f2bb.zip
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 <noreply@anthropic.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md36
1 files changed, 36 insertions, 0 deletions
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 <gateway host> <security code from the gateway label>
+
+## Usage
+
+ agent-lamp <state> <session> 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. <danix@danix.xyz>
+
+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.