Higangssh/homebutler

解決する問題

HomeButler は、ホームラボ保守の「混沌とした中間部分」に対処します。サーバーは時間の経過とともにドリフトし、管理が困難になります。前回確認してからサーバーで何が変わったのか分からないという問題を解決し、サービスが再起動する理由、ポートが誤ったプロセスに占有されていないか、バックアップが実際に復元可能かどうかを特定するのに役立ちます。

仕組み

これは Go バイナリで、常駐デーモンやデータベースを必要とせずに運用ツールキットとして機能します。サーバーの状態（コンテナ、ポート、プロセス）のスナップショットを取得し、以前のベースラインと比較します。変更点（例：「新規」、「消失」、「置換」）の構造化されたバトラー風レポートを提供し、事前チェック用の「doctor」コマンドと、バックアップが正常に起動してヘルスチェックに合格できることを検証する「drill」機能を含みます。

対象ユーザー

これは、サーバーを監視するための明確で構造化されたインターフェースを求めるセルフホスターやホームラボ愛好家向けです。また、AIエージェントや自動化スクリプトでの使用も想定されており、すべての診断および監視機能に対して機械可読な JSON 出力を提供します。

ハイライト

• 変更検出： コンテナの再作成、イメージ更新、ポート所有権の変更などの変更を自動的に識別して分類します。
• バックアップ検証： 隔離されたコンテナでバックアップを起動して機能を確認する drill コマンドを含みます。
• エージェントフレンドリー： MCP（モデルコンテキストプロトコル）または CLI を介して AI エージェントが使用できるように設計されており、完全な SSH シェルアクセスなしで構造化データを提供します。
• デーモン不要： SSH 経由で実行されるスタンドアロンツールとして動作し、サーバーフットプリントを最小限に抑えます。
• クラッシュ分析： Docker、systemd、PM2 サービスを監視してログを取得し、OOM（メモリ不足）やセグメンテーションフォールトなどのクラッシュ原因を分析します。