homebutler
🏠 Tells you what changed on your server — only what's worth telling. Single Go binary, no database, nothing running on the machines it watches. MCP server buil
What is homebutler?
🏠 Tells you what changed on your server — only what's worth telling. Single Go binary, no database, nothing running on the machines it watches. MCP server built in.
Overview of homebutler
What it is
HomeButler is a single Go binary that remembers what your server looked like last time and tells you — or an AI agent — what moved. It requires no daemon, no database, and nothing running on the machines it watches. It provides a narrow, structured interface to the server, returning readable summaries and JSON instead of a full shell session.
Key features
- Single Go binary, no database, no agent on watched machines (runs over SSH)
- Reports changes with eight distinct kinds: gone, new, replaced, image, state, port, disk, skipped - Built-in MCP server for AI agent integration - Backup verification via
backup drill: boots archives in isolated containers and requires HTTP health check - Doctor check: read-only preflight for resource pressure, stopped containers, backup hygiene, etc. - Install self-hosted apps (Uptime Kuma, Jellyfin, Pi-hole, Gitea, Portainer, etc.) with one command - Terminal dashboard (
watch tui) and web dashboard (serve)
Use cases
- Answer what is running on the server right now - Identify which container owns a specific port - Detect why a service restarted at 3 AM - Verify that a backup is actually restorable - Let an AI assistant inspect the server without handing it a full SSH shell - Monitor changes across multiple machines from a central hub
Getting started
bash # One-line install (auto-detects OS/arch) curl -fsSL https://raw.githubusercontent.com/Higangssh/homebutler/main/install.sh | sh # Or via Homebrew brew install Higangssh/homebutler/homebutler # Or as a container docker run -d -p 8080:8080 -v ~/.config/homebutler:/config -v ~/.ssh:/root/.ssh:ro ghcr.io/higangssh/homebutler serve --host 0.0.0.0 --token $(openssl rand -hex 16) # Interactive setup homebutler init # Use it right away homebutler status homebutler docker list homebutler inventory scan homebutler report homebutler install uptime-kuma homebutler backup drill uptime-kuma homebutler watch tui homebutler serve
License and pricing
License: MIT. Pricing: open source (free).
Based on the project's public README and repository metadata.