CLI

The kog CLI is installed per-project (npx kog … or via package scripts). Everything is Node — no external tools.

Commands

kog dev

Dev server + hot reload. Compiles on save and broadcasts to all targets (simulator and/or devices over USB/Wi-Fi); streams console.* and errors back. Interactive keys: rescan devices, force reload, open simulator.

--target sim|device|all (default: all if a board is present, else sim)

kog build

Type-check (tsc --noEmit, fails on type errors) → compile → bundle → bytecode. Outputs a deployable signed bundle.

--release — optimizations on, console stripped.

kog flash

First-time or full flash over USB: detects the board, downloads the matching prebuilt runtime, writes runtime + board config + current app.

--runtime — upgrade only the runtime (app/settings preserved) · --port <p> — explicit serial port

kog deploy

Push the built app bundle to a device as the installed app (OTA path with staging + rollback). Works over Wi-Fi or USB.

kog simulate

Launch the simulator without the dev server (runs the last built bundle).

kog doctor

Environment check: Node version, serial access, simulator binary, board detection — every failure paired with its fix.

kog board validate

Validate board.yaml against the schema; explains any mismatch.

kog firmware build

Compile a custom runtime from board.yaml (Tier C). First run bootstraps the managed toolchain automatically. See Boards.

kog wifi

Provision Wi-Fi credentials over a USB-connected device.

create-kog

Project scaffolding — invoked as npm create kog@latest [name].