HomeButler – ein kleiner Butler-CLI für den Home-Server

Seit der Vorstellung vor einem Monat entwickle ich es kontinuierlich weiter – von einem einfachen CLI für Home-Server-Verwaltung hin zu einem „Betriebs-Butler für den Home-Server“.

HomeButler ist ein Go-Single-Binary-CLI für kleine Home-Server. Am Anfang war es ein Tool, das häufig genutzte Befehle wie status, docker und ports an einem Ort bündelt. Beim Entwickeln wurde mir aber klar, dass die wirklich schwierige Aufgabe nicht die „Installation“, sondern das „dauerhafte Kümmern“ ist.

• Was läuft gerade?
• Welcher Container verwendet diesen Port?
• Lassen sich Backups wirklich wiederherstellen?
• Ich möchte den Server einer AI anvertrauen – kann ich ihr einfach unverändert Shell-Rechte geben?

Was aktuell möglich ist

homebutler status                    # CPU, memory, disk, uptime  
homebutler docker list               # running containers  
homebutler ports                     # open ports  
homebutler inventory scan            # containers + ports + topology  
homebutler install uptime-kuma       # deploy a self-hosted app  
homebutler backup drill uptime-kuma  # verify a backup actually restores  
homebutler report                    # health report + change summary  
homebutler watch tui                 # terminal dashboard  
homebutler serve                     # web dashboard  

Ausrichtungsprinzipien

• Go Single Binary, läuft ohne Daemon/DB
• CLI-first, mit Unterstützung für JSON-Ausgabe
• Kann auf einen Remote-Server kopiert und sofort genutzt werden
• Anbindung an AI-Tools über einen MCP-Server — statt einer rohen Shell werden der AI nur strukturierte Befehle offengelegt

Das kürzlich hinzugefügte report

Beim ersten Start wird ein Baseline-Snapshot gespeichert, danach wird der aktuelle Zustand mit dem vorherigen verglichen und ein gut lesbarer Report erstellt. Standardmäßig werden nur 30 Snapshots aufbewahrt.

🏠 Homebutler Report — mac-mini  
  
── Current Status ──  
   CPU: 5.0% (10 cores), Memory: 8.3/16.0 GB (52%)  
   Containers: 1 running, 1 stopped  
  
── Needs Attention ──  
   ⚠️  1 container(s) stopped  
  
── Suggested Actions ──  
   → Address items in 'Needs attention' above.  

In Zukunft möchte ich es in Richtung doctor, diff und fix --plan weiterentwickeln – von einem „Tool, das Probleme meldet“ zu einem „Butler, der auch die nächsten Schritte vorschlägt“.

GitHub: https://github.com/Higangssh/homebutler
Webseite: https://homebutler.dev

Wenn es etwas gibt, bei dem euch so ein Butler ebenfalls helfen sollte, freue ich mich über Feedback.