Show GN: HomeButler – 홈서버를 챙겨주는 작은 집사 CLI

한 달 전 소개 이후, 단순 홈서버 관리 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

"이런 것도 집사가 봐줬으면 좋겠다" 싶은 부분이 있으면 피드백 부탁드립니다.