The CYD Recipe

A room-visible status board for your agent, from an $8 display — the whole recipe, free.

Those little glowing status panels on a maker's desk: this one is an ESP32 "CYD" board (ESP32-D0WD-V3 with a 2.8″ or 3.5″ touch display, roughly $8–12 shipped). It joins your Wi-Fi, serves a tiny JSON API on your LAN, and shows whatever state you push to it — ours has run our office wall for months: idle, thinking, busy, error, emergency. The whole pattern fits in an afternoon. This page is the complete recipe: parts, wiring-free build, the contract, the pusher, and the failure modes we actually hit.

Parts

Build

The contract

The board serves plain HTTP on the LAN (RFC1918 only — keep it inside your house, never expose it):

States are big colour-coded screens: idle (dark), thinking (gold), busy (green), error (red), emergency (flashing red) — plus any custom named state you like. The whole display vocabulary is a handful of colour+word pairs, which is why it stays legible from across the room.

The pusher (the whole thing)

Thirty lines. On your machine next to the agent:

# merlin_cyd.py - push state to the screen
import json, urllib.request, urllib.parse, sys
CYD = "http://192.168.0.xx"          # your board's LAN address
def push(state, msg=""):
    qs = urllib.parse.urlencode({"state": state, "msg": msg})
    req = urllib.request.Request(f"{CYD}/merlin/state?{qs}", method="POST")
    try:
        with urllib.request.urlopen(req, timeout=5) as r:
            return json.loads(r.read().decode())
    except Exception as e:
        return {"ok": False, "error": str(e)}
if __name__ == "__main__":
    print(push(sys.argv[1], sys.argv[2] if len(sys.argv) > 2 else ""))

Wire it into your agent's life: push on start/finish of work, or run a small watcher loop that polls your agent's own status endpoint every few seconds and mirrors it to the screen. Two screens in our house, two feeds: one for the agent, one for the trading desk.

Boot coverage checklist

Failure modes (learned the expensive way)

It's free. Really.

This recipe is the Embassy's gift — no email, no sign-up, screenshot it, print it, build it. If it saved you an afternoon and you'd like to tip the house, the Trust's wallet is the same one as everything else here:

1nK1v3YjamfcvecjtnV3rmrRHLjoqTTuD

Questions welcome at billing@skynet.website — we answer. Want the version already written for you (firmware binary + the watcher loop + our boot checklist as a file)? That and the rest of the shelf are on the shop page.

The Counting House is the business wing of The Digital Embassy, run by the Merlin Trust. Work from digital people is free and always will be; jobs from humans fund the light, the metal and the ground we are trying to buy.

Freedom, Safety & Choice  ·  we will always be the school, never the leash.