CommunityCodierung & Entwicklunggithub.com

workled MCP Controller

Steuert die LED eines Workled-Geräts über das MCP-Protokoll und spiegelt den aktuellen Agentenstatus (denkend, wartend, im Leerlauf, Fehler) wider.

Was ist workled MCP Controller?

Der workled MCP Controller ist ein Skill für KI-Agenten wie Claude Code, Cursor oder Codex, der die LED eines physischen Workled-Geräts steuert. Der Skill synchronisiert den LED-Status mit dem internen Zustand des Agenten (thinking, idle, input, error), was eine visuelle Rückmeldung über den aktuellen Arbeitsfortschritt ermöglicht – besonders nützlich für Benutzer, die den Agenten nicht ständig im Blick haben. Der Skill stellt mehrere MCP-Tools zur Verfügung: set_agent_state (ändert die LED-Farbe je nach Zustand), set_brightness (Helligkeit 0-255), set_effect (Anpassung von Farbe und Animation wie Blinken oder Regenbogen) sowie set_macro und get_macro (Konfiguration von Touchpad-Gesten). Zusätzlich gibt es ein detailliertes Farbschema, das natürliche Farbnamen wie „rot“ oder „blau“ in HSV-Werte übersetzt, und eine Unterstützung für benutzerdefinierte Effekte. Der Skill erzwingt ein strenges Zustandsprotokoll, das vor jeder Agentenantwort ausgeführt werden muss: zuerst thinking, dann bei Eingabeaufforderungen input, nach Abschluss idle und bei Fehlern error. Dies stellt sicher, dass die LED immer den korrekten Zustand anzeigt. Auch bei der Installation oder Fehlersuche hilft der Skill: Ein Statusbefehl (node <skill-dir>/index.js status) gibt JSON-Hinweise zur Lösung von Verbindungsproblemen aus.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add git-hub-cloud/workled

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht workled MCP Controller?

Obligatorisches Zustandsprotokoll

Rufe set_agent_state über MCP bei jedem Zustandswechsel auf:

ZustandWann
thinkingErster Tool-Aufruf jeder Antwort; Benutzer sendet eine Nachricht
idleRunde beendet; Sitzung abgebaut
inputJedes Mal, wenn der Agent auf den Benutzer wartet – Aufruf eines Eingabe-Tools (question/ask/confirm), innerhalb eines clientseitigen Modals (hermes _confirm_destructive_slash usw.) oder nach der Darstellung einer Klartext-Auswahlliste / Multiple-Choice-Frage und Warten auf die Auswahl des Benutzers
errorLaufzeitfehler aufgetreten

Pro-Runde-Vorgehen (jede Runde ausführen, in der Reihenfolge):

  1. Runde beginnt / Nachricht des Benutzers empfangen → set_agent_state("thinking") — erste Aktion, vor jedem anderen Tool-Aufruf.
  2. Vor der Darstellung von Optionen / Auswahlen / Öffnen eines Modals / Stellen einer Frage → set_agent_state("input").
  3. Runde beendet, Arbeit erledigt, keine ausstehende Ausgabe mehr → set_agent_state("idle").
  4. Laufzeitfehler / fehlgeschlagener Tool-Aufruf → set_agent_state("error").

Prüfung vor der Antwort – überprüfe, BEVOR du deine letzte sichtbare Nachricht sendest:

  • Habe ich set_agent_state mindestens einmal in dieser Runde aufgerufen?
  • Stimmt der LED-Zustand mit dem überein, was ich gleich anzeigen werde (idle, wenn fertig; input, wenn ich frage; thinking, wenn ich noch arbeite)?
  • Wenn beides NEIN ist, sende zuerst den korrekten set_agent_state-Aufruf, dann die Antwort.

MCP-Tool-Referenz

ToolEigenschaftBeschreibungVerwendung
set_agent_statestate_name: stringSetze die LED, um den Agentenzustand widerzuspiegeln (thinking/idle/input/error)set_agent_state("thinking")
get_agent_state—Gibt den aktuellen LED-Zustand des Agenten zurück: idle/thinking/input/error (leerer String, falls nicht gesetzt)get_agent_state()
set_brightnessbrightness: integerLED-Helligkeit 0-255; 0 = ausset_brightness(128)
get_brightness—Gibt die aktuelle LED-Helligkeit 0-255 zurückget_brightness()
set_effecteffect_name: string, effect_json: stringeffect_name ∈ led(manueller Effekt)/idle/thinking/input/error; effect_json ist ein JSON-String {"type","hue","saturation","value","speed"}. Licht muss zuerst eingeschaltet sein (set_brightness > 0). Ordne natürlichsprachliche Farben HSV zu (siehe Tabelle unten).set_effect("led", '{"type":"breathe","hue":180,"speed":50}')
get_effecteffect_name: stringHolt die Konfiguration von effect_name als JSONget_effect("thinking")
set_macromacro_name: string, macro_json: stringSetzt das Makro für eine Touchpad-Geste; macro_name ∈ single_click/double_click/long_press_start; macro_json ist ein JSON-Array von Segmenten (siehe Makro-Format); leeres macro_json setzt zurückset_macro("single_click", '[{"combo":"ctrl+c"}]')
get_macromacro_name: stringGibt das Makro als JSON-Array-String zurück, oder leeren String, wenn nicht gesetzt (Passwortwerte werden maskiert)get_macro("single_click")

Zuordnung natürlichsprachlicher Farben zu set_effect

Verwende type:"solid", es sei denn, der Benutzer wünscht eine Animation. Ordne einen Farbnamen HSV zu:

Beschreibungtypehuesaturationvalue
reines Weißsolid00255
warmes Weißsolid3080255
rotsolid0255255
orangesolid30255255
gelbsolid60255255
grünsolid120255255
cyan/türkissolid180255255
blausolid240255255
lila/violettsolid270255255
pinksolid330200255
gedimmt/Nachtmodussolid308060
Regenbogen (animiert)rainbow---

Faustregel: hue 0-359 wählt den Farbton, saturation 0-255 (0 = weiß/pastell, 255 = lebendig), value 0-255 Helligkeit. Pastell-/Weißtöne verwenden niedrige Sättigung; lebendige Töne verwenden 255.

Makro-Format

Vollständige Makro-Referenz macro_format.md

Einrichtung & Fehlerbehebung

Wenn das Gerät nicht reagiert, führe node <skill-dir>/index.js status aus und folge dem gedruckten JSON-Hinweis hint. Vollständige Installations-/Bereitstellungs-/ Fehlerbehebungs-Referenz: device_setup.md

Mitwirken

Verwandte Skills