HomeButler – CLI pelayan kecil yang merawat homeserver

Sejak diperkenalkan sebulan lalu, proyek ini terus berkembang dari CLI pengelolaan homeserver sederhana menjadi alat yang mengarah ke peran "pelayan operasional homeserver".

HomeButler adalah CLI single binary berbasis Go untuk homeserver kecil. Awalnya ini adalah alat yang mengumpulkan perintah-perintah yang sering dipakai seperti status, docker, dan ports di satu tempat, tetapi dalam proses pembuatannya saya merasa bahwa hal yang benar-benar sulit bukanlah "instalasi", melainkan "merawatnya secara berkelanjutan".

• Sekarang apa saja yang sedang berjalan?
• Kontainer mana yang memakai port ini?
• Apakah backup benar-benar bisa dipulihkan?
• Saya ingin menyerahkan server ke AI, tetapi amankah memberi izin shell apa adanya?

Yang saat ini bisa dilakukan

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  

Arah desain

• Go single binary, berjalan tanpa daemon/DB
• CLI-first, mendukung output JSON
• Bisa langsung dipakai dengan menyalinnya ke server jarak jauh
• Terintegrasi dengan alat AI melalui server MCP — ke AI hanya diekspos perintah terstruktur, bukan raw shell

report yang baru ditambahkan

Saat dijalankan pertama kali, fitur ini menyimpan baseline snapshot, lalu pada eksekusi berikutnya membandingkannya dengan status sebelumnya untuk membuat laporan yang mudah dibaca manusia. Snapshot yang disimpan dibatasi hanya 30 secara default.

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

Ke depannya, saya ingin mengembangkannya lewat arah doctor, diff, dan fix --plan, dari "alat yang memberi tahu ada masalah" menjadi "pelayan yang juga menyarankan tindakan berikutnya".

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

Kalau ada hal yang menurut Anda juga sebaiknya dipantau oleh pelayan seperti ini, saya akan sangat menghargai masukan Anda.