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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/higangsshhomebutler.svg)](https://yunodb.com/tools/higangsshhomebutler?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/higangsshhomebutler?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/higangsshhomebutler.svg" alt="Featured on YunoDB" height="20"></a>