HomeButler – un pequeño mayordomo CLI para cuidar tu servidor casero

Desde que lo presenté hace un mes, ha seguido evolucionando de un simple CLI de gestión de servidor casero hacia la idea de un “mayordomo de operaciones para el servidor casero”.

HomeButler es un CLI de binario único en Go para pequeños servidores caseros. Al principio era una herramienta para reunir en un solo lugar comandos de uso frecuente como status, docker y ports, pero mientras lo desarrollaba pensé que lo realmente difícil no era la “instalación”, sino “seguir atendiéndolo de forma continua”.

• ¿Qué está corriendo ahora mismo?
• ¿Qué contenedor está usando este puerto?
• ¿Los respaldos realmente se pueden restaurar?
• Quiero dejar el servidor en manos de una IA, pero ¿está bien darle permisos de shell tal cual?

Lo que puede hacer actualmente

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  

Dirección de diseño

• Binario único en Go, funciona sin daemon ni DB
• CLI-first, con soporte para salida JSON
• Se puede copiar a un servidor remoto y usar de inmediato
• Integración con herramientas de IA mediante un servidor MCP — en vez de exponer un shell sin filtrar a la IA, solo se exponen comandos estructurados

report añadido recientemente

En la primera ejecución guarda una instantánea base y, después, compara con el estado anterior para generar un reporte fácil de leer. Por defecto solo conserva 30 instantáneas.

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

A futuro, quiero llevarlo en la dirección de doctor, diff y fix --plan, para hacerlo crecer de una “herramienta que te avisa de los problemas” a “un mayordomo que incluso te sugiere la siguiente acción”.

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

Si hay algo de lo que te gustaría que este mayordomo también se encargara, agradeceré mucho tu feedback.