Wireless development

After first flash, the cable is optional. A Kog device on your network advertises itself over mDNS; kog dev discovers it and connects a WebSocket for hot reload, logs, and deploys.

Setup

During the first USB flash, the CLI offers to store your Wi-Fi credentials on the device. Alternatively, any Kog device without credentials boots into a small provisioning screen (hotspot + captive portal) where you can enter them from your phone.

Daily loop

npm run dev

kog dev
◐ Compiling app…            ✔ 214 ms  (11.9 KB bytecode)
◐ Looking for devices…      ✔ kitchen-display (192.168.1.44, wireless)
● 2 targets: simulator + kitchen-display. Save to hot-reload both.

Every save compiles once and broadcasts the bundle to all attached targets — the simulator and any number of devices — which reload in ~1–2 seconds, keeping your current screen. console.log from every target streams back to the same terminal, labeled by source.

Deploying without the dev server

npx kog deploy               # push the current app to a device as a persistent install
npx kog deploy --release     # optimized bundle, console stripped

Deploys use the same over-the-air mechanism as production OTA updates: staged write, integrity check, atomic swap, automatic rollback if the new bundle fails to boot.