Summary

The state of the house becomes something you can ask about mid-sentence.

Rooms, devices and their current state come back as structured data, and the same connection sends the command — so "is the garage light still on" and "turn it off" are one exchange instead of an app and a second thought.

What it is

A small layer over the SmartThings API covering four things: your rooms, your devices, the current state of a device, and the commands that change it. It runs locally over stdio, or as the container the repository ships.

What you get

Every room in the home, as UUIDs mapped to the names you gave them
The device list, with filtering, so a large home does not arrive as one wall of devices
The current status of any device, looked up by its UUID
Commands sent to a device, so a reading and the action that follows it happen on one connection

Requirements

A SmartThings personal token, passed to the server as TOKEN. Then either uv, to run it from source, or Docker — the included Dockerfile takes the same token as an environment variable.