Hinweis: Der Beitrag wurde mit KI-Unterstützung (Claude Code) verfasst und manuell nachbearbeitet.
Meine Home-Assistant-Automationen laufen als C#-Apps in NetDaemon, nicht mehr als YAML. NetDaemon läuft dabei im "Source-Deploy"-Modus: Die .cs-Dateien werden beim Start direkt kompiliert, kein separater Build-Schritt nötig. Der Haken daran: Ein Tippfehler, und der komplette Prozess startet nicht mehr — alle Apps sind tot, bis der Fehler behoben ist. Und dafür brauchte es bisher immer einen Laptop mit VPN oder SSH-Zugriff.
NetDaemon Toolkit ist eine kleine Home-Assistant-Integration, die genau das überflüssig macht: NetDaemon lässt sich damit komplett aus dem HA-Frontend heraus verwalten — und damit auch von unterwegs, über Nabu Casa, ganz ohne VPN oder Portfreigabe.
Was das Toolkit kann
- Datei-Editor für die
.cs-Dateien der NetDaemon-Apps, direkt in einer Sidebar in Home Assistant. Mehrere Dateien als Tabs offen, Suchen/Ersetzen, Sprung zu einer Zeile — kein vollwertiges IDE-Ersatz, aber genug für einen schnellen Fix zwischendurch. - Reload-Button, der NetDaemon nach einer Änderung sauber neu startet, damit der Edit auch wirksam wird.
- Status-Anzeige, die per Heartbeat-Datei sofort zeigt, ob NetDaemon läuft und ob der letzte Edit überhaupt kompiliert hat — kein Rätselraten mehr, ob der Reload geklappt hat.
- Ein-Klick-Neugenerierung der typisierten Home-Assistant-Entities (
nd-codegen), ohne dafür extra am Rechner sitzen zu müssen. - Log-Ansicht, optional, für den Fall, dass doch mal ein Blick in die rohen NetDaemon-Logs nötig ist — auch dann, wenn der letzte Edit den Build kaputt gemacht hat.
- Webhook-Relay: externe Webhooks lassen sich direkt in NetDaemon-Events umwandeln, ohne den Umweg über eine YAML-Automation.
- Entscheidungsverlauf pro App: jede App kann ihre eigenen Reaktionen protokollieren, im Panel als durchsuchbare Historie einsehbar — nützlich, um im Nachhinein nachzuvollziehen, warum eine App zu einem bestimmten Zeitpunkt etwas (nicht) gemacht hat.
Ein Blick unter die Haube
Ein paar Dinge, die vielleicht überraschen:
Die Toolkit-Integration läuft komplett innerhalb von Home Assistant, aber Reload und Codegen passieren nicht dort — sie werden über ein HA-Event angestoßen, das drei kleine NetDaemon-eigene Apps abfangen (werden beim Einrichten automatisch mit angelegt, falls noch nicht vorhanden). Der Reload-Button etwa feuert nur ein Event; eine NetDaemon-App hört darauf und beendet daraufhin den eigenen Prozess — der Container-Supervisor startet ihn neu, und NetDaemon kompiliert die geänderten Dateien frisch.
Die Entity-Neugenerierung läuft als reiner Subprozess innerhalb von NetDaemon selbst — nd-codegen wird bei Bedarf installiert und ausgeführt, mit den Zugangsdaten, die NetDaemon ohnehin schon hat.
Und die Log-Ansicht braucht keinen Docker-Socket und keine Docker-API: Sie liest stattdessen die Log-Datei, die Docker für jeden Container ohnehin schon selbst mitschreibt, über einen gezielten, read-only Mount genau dieser einen Datei. Das Toolkit kommt dadurch komplett ohne erweiterten Zugriff auf den Host aus — für niemanden, der es installiert.
Installation
NetDaemon Toolkit lässt sich per HACS als Custom Repository installieren:
https://github.com/markusstephany/netdaemon-toolkit
Voraussetzung ist eine NetDaemon-Instanz im Source-Deploy-Modus, deren App-Ordner auch für Home Assistant sichtbar ist (Bind-Mount). Installationsschritte stehen im README, technische Details (Source-Deploy-Eigenheiten, Log-Ansicht-Setup, die NetDaemon-eigenen Apps) in docs/architecture.md.
Entwickelt mit Claude Code
Editor, Reload-Mechanismus, Codegen, Log-Ansicht, Webhook-Relay, Entscheidungsverlauf — das Ganze ist Stück für Stück im Dialog mit Claude Code entstanden. Ich gebe die Richtung und die Anforderungen vor, Claude setzt um und erklärt die Architektur-Entscheidungen dahinter — praktisch, um auch außerhalb reiner NetDaemon-App-Logik zu einem brauchbaren Ergebnis zu kommen, ohne mich tief in Home-Assistant-Custom-Component-Entwicklung einarbeiten zu müssen.
Fazit
- NetDaemon Toolkit verwaltet eine NetDaemon-Instanz komplett aus dem HA-Frontend heraus
- Editor, Reload, Status, Entity-Codegen, Log-Ansicht, Webhook-Relay, Entscheidungsverlauf
- Kein Docker-Socket, keine Docker-API — an keiner Stelle
- Installierbar per HACS: https://github.com/markusstephany/netdaemon-toolkit