xgg

What xgg does

xgg combines Mi Home cloud control with rule-graph automation on the central hub gateway. The cloud side handles device discovery, property reads and writes and actions. The hub side handles rule graphs, variables, backups, habit learning and run logs.

It outputs stable JSON with actionable errors, and the npm package carries a self-contained skill so agents such as Codex and Claude can operate rule graphs. Safety features include pre-write snapshots, change leases, strict schema checks, lint, and creation disabled by default. The repo has two packages, @eyaeya/xgg-core and @eyaeya/xgg-cli. The README is mainly in Chinese.

Key features

• Direct Mi Home cloud device reads, writes and actions
• Rule-graph automation on the central hub with 25 executable node types
• Stable JSON output and an agent skill bundled in the npm package
• Write safeguards: snapshots, leases, strict validation and lint
• Rule export, import, clone and backup

When to use it

• Asking an agent to write and verify a home automation
• Debugging a rule using logs and traces
• Backing up and cloning central hub rules

Who it is for: Xiaomi smart-home users who want an AI agent such as Hermes to operate devices and automations.

How it fits with Hermes Agent

xgg is a general tool whose description names Codex, Claude, OpenClaw and Hermes as agents that can drive it.

Requirements: A Mi Home account scan for authorization and a Xiaomi central hub gateway

Note: The README is mainly in Chinese and states it does not claim full parity with the upstream mijia-api project.

FAQ