HomeButler – ホームサーバーを世話してくれる小さな執事CLI

1か月前に紹介して以降、単純なホームサーバー管理CLIから「ホームサーバー運用の執事」という方向へ継続的に発展させています。

HomeButlerは、小さなホームサーバー向けのGo製シングルバイナリCLIです。最初は status、docker、ports のようなよく使うコマンドをひとまとめにするツールでしたが、作っていくうちに本当に難しいのは「導入」よりも 「継続して面倒を見ること」 だと感じるようになりました。

• 今、何が動いているのか？
• どのコンテナがこのポートを使っているのか？
• バックアップは本当に復元できるのか？
• AIにサーバーを任せたいが、shell権限をそのまま渡しても大丈夫なのか？

現在できること

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  

設計方針

• Go single binary、daemon/DBなしで動作
• CLI-first、JSON出力対応
• リモートサーバーにコピーしてすぐ使える
• MCPサーバーとしてAIツールと連携 — AIにはraw shellの代わりに 構造化されたコマンドだけ を公開

最近追加した report

初回実行時にbaseline snapshotを保存し、その後は前回の状態と比較して人間が読みやすいレポートを作成します。スナップショットはデフォルトで30件だけ保持します。

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

今後は doctor、diff、fix --plan の方向へ、「問題を知らせるツール」から 「次の行動まで提案する執事」 へ育てていきたいと考えています。

GitHub: https://github.com/Higangssh/homebutler
ウェブサイト: https://homebutler.dev

「こんなことも執事に見てほしい」と思う点があれば、ぜひフィードバックをお願いします。