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

> Clean Markdown view of GeekNews topic #29015. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=29015](https://news.hada.io/topic?id=29015)
- GeekNews Markdown: [https://news.hada.io/topic/29015.md](https://news.hada.io/topic/29015.md)
- Type: show
- Author: [swq115](https://news.hada.io/@swq115)
- Published: 2026-04-29T21:36:12+09:00
- Updated: 2026-04-29T21:36:12+09:00
- Original source: [github.com/Higangssh](https://github.com/Higangssh/homebutler)
- Points: 1
- Comments: 0

## Topic Body

한 달 전 소개 이후, 단순 홈서버 관리 CLI에서 "홈서버 운영 집사" 방향으로 계속 발전시키고 있습니다.  
  
HomeButler는 작은 홈서버를 위한 Go 싱글 바이너리 CLI입니다. 처음엔 `status`, `docker`, `ports` 같은 자주 쓰는 명령을 한곳에 모으는 도구였는데, 만들다 보니 진짜 어려운 건 "설치"보다 **"계속 챙기는 일"** 이라는 생각이 들었습니다.  
  
- 지금 뭐가 떠 있지?  
- 어떤 컨테이너가 이 포트를 쓰고 있지?  
- 백업은 진짜 복구되나?  
- AI에 서버를 맡기고 싶은데 shell 권한을 그대로 줘도 되나?  
  
**현재 할 수 있는 것들**  
  
```bash  
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  
  
"이런 것도 집사가 봐줬으면 좋겠다" 싶은 부분이 있으면 피드백 부탁드립니다.

## Comments



_No public comments on this page._