HomeButler – um pequeno mordomo CLI para cuidar do seu home server

Desde a apresentação de um mês atrás, ele vem evoluindo continuamente de um simples CLI de gerenciamento de home server para a direção de um "mordomo de operação de home server".

HomeButler é um CLI em Go, single binary, para pequenos home servers. No começo, era uma ferramenta para reunir em um só lugar comandos usados com frequência, como status, docker e ports, mas, conforme fui desenvolvendo, percebi que a parte realmente difícil não é a "instalação", e sim "cuidar continuamente".

• O que está rodando agora?
• Qual contêiner está usando esta porta?
• O backup realmente restaura?
• Quero deixar o servidor nas mãos de uma IA, mas posso dar permissão de shell direta assim mesmo?

O que já pode fazer atualmente

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  

Direção de design

• Go single binary, funciona sem daemon/DB
• CLI-first, com suporte a saída JSON
• Pode ser copiado para um servidor remoto e usado imediatamente
• Integração com ferramentas de IA via servidor MCP — expõe à IA apenas comandos estruturados, em vez de shell bruto

report adicionado recentemente

Na primeira execução, ele salva um baseline snapshot e, depois disso, compara com o estado anterior para gerar um relatório fácil de ler para humanos. Por padrão, mantém apenas 30 snapshots.

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

Daqui para frente, quero expandir na direção de doctor, diff e fix --plan, transformando-o de uma "ferramenta que avisa sobre problemas" em um "mordomo que sugere até a próxima ação".

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

Se houver algo que você pense "seria bom se esse mordomo também cuidasse disso", fico feliz em receber feedback.