github.com/Higangssh/homebutler (link)

---
name: homebutler
description: Homelab server operations via homebutler CLI/MCP. Check system status, generate butler reports, scan inventory/topology, manage Docker containers, install self-hosted apps, verify backup drills, Wake-on-LAN, port scanning, alerts, backup/restore, and multi-server SSH.
metadata:
  {
    "openclaw": {
      "emoji": "🏠",
      "requires": { "anyBins": ["homebutler"] },
      "configPaths": ["homebutler.yaml", "~/.config/homebutler/config.yaml"]
    }
  }
---

# Homebutler

# homebutler

> Single-binary homelab management CLI for servers, Docker, app installs, backup/restore, Wake-on-LAN, SSH multi-server workflows, and AI/MCP tooling.

## What it does
- `watch`: restart detection, crash analysis, flapping detection, incident history
- `watch tui`: terminal dashboard for all configured servers
- `serve`: embedded web dashboard with no separate frontend runtime
- Docker management: list, restart, stop, logs, stats
- App install: one-command self-hosted app deployment
- Backup/r

# homebutler

A single Go binary for running a small home server: CLI, TUI, web dashboard, and
an MCP server, with no daemon and no database.

## Verify before claiming anything works

```bash
gofmt -w .
go vet ./...
golangci-lint run
go test ./...
go build ./...
```

All five must pass. `go test ./...` takes several minutes — `internal/network`
and `internal/remote` wait on real timeouts — so start it early rather than
running it last.

## Writing commits, PRs, and comments

Everything written here is