HomeButler – CLI quản gia nhỏ chăm sóc home server

Sau khi được giới thiệu cách đây một tháng, công cụ này đang tiếp tục phát triển từ một CLI quản lý home server đơn giản theo hướng trở thành một "quản gia vận hành home server".

HomeButler là CLI Go dạng single binary dành cho các home server nhỏ. Ban đầu, đây là công cụ gom các lệnh thường dùng như status, docker, ports vào một chỗ, nhưng trong quá trình làm, tôi nhận ra điều thực sự khó không phải là "cài đặt" mà là "liên tục theo dõi và chăm sóc".

• Hiện giờ đang có gì chạy?
• Container nào đang dùng cổng này?
• Bản sao lưu có thực sự khôi phục được không?
• Tôi muốn giao server cho AI, nhưng có ổn không nếu cấp nguyên quyền shell?

Những gì hiện tại có thể làm

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  

Định hướng thiết kế

• Go single binary, chạy không cần daemon/DB
• CLI-first, hỗ trợ xuất JSON
• Có thể chép sang server từ xa và dùng ngay
• Tích hợp với công cụ AI qua MCP server — thay vì raw shell, chỉ phơi bày các lệnh có cấu trúc cho AI

report được thêm gần đây

Ở lần chạy đầu tiên, công cụ sẽ lưu baseline snapshot, và từ đó về sau sẽ so sánh với trạng thái trước đó để tạo báo cáo dễ đọc cho con người. Mặc định chỉ giữ lại 30 snapshot.

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

Trong thời gian tới, dự án sẽ phát triển theo hướng doctor, diff, fix --plan, từ một "công cụ cho biết có vấn đề gì" thành "một quản gia đề xuất cả hành động tiếp theo".

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

Nếu có phần nào bạn nghĩ rằng "giá mà quản gia cũng lo được việc này", rất mong nhận được phản hồi.