aboutsummaryrefslogtreecommitdiffstats

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

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. danix@danix.xyz

GPLv2 only. See 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.