HomeButler – le petit majordome CLI qui veille sur votre home server

Depuis sa présentation il y a un mois, le projet continue d’évoluer, passant d’un simple CLI de gestion de home server à un véritable « majordome d’exploitation » pour home server.

HomeButler est un CLI Go en binaire unique conçu pour les petits home servers. Au départ, c’était un outil qui regroupait en un seul endroit des commandes fréquemment utilisées comme status, docker et ports, mais en le développant, je me suis dit que la vraie difficulté n’était pas tant « l’installation » que « le suivi dans la durée ».

• Qu’est-ce qui tourne en ce moment ?
• Quel conteneur utilise ce port ?
• Les sauvegardes sont-elles vraiment restaurables ?
• J’aimerais confier le serveur à une IA, mais puis-je vraiment lui donner directement des permissions shell ?

Ce qu’il sait faire actuellement

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  

Orientation de conception

• Binaire unique Go, fonctionne sans daemon ni base de données
• CLI-first, avec prise en charge de la sortie JSON
• Peut être copié sur un serveur distant et utilisé immédiatement
• Intégration avec des outils IA via un serveur MCP — expose à l’IA uniquement des commandes structurées, au lieu d’un shell brut

Le report ajouté récemment

Au premier lancement, il enregistre un snapshot de référence, puis compare ensuite l’état courant à l’état précédent pour générer un rapport lisible par un humain. Par défaut, seuls les 30 derniers snapshots sont conservés.

🏠 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.  

Par la suite, j’aimerais le faire évoluer vers doctor, diff et fix --plan, afin de passer d’un « outil qui signale les problèmes » à un véritable « majordome qui suggère aussi la prochaine action ».

GitHub: https://github.com/Higangssh/homebutler
Site web : https://homebutler.dev

S’il y a des aspects pour lesquels vous vous dites « ce serait bien que le majordome s’en charge aussi », je serais ravi d’avoir vos retours.