# Working on this project

This is a WAI project made from the `remote-desktop` template: one machine's screen shared into a
room. `wai dev` runs the room in remote desktop mode; `host.sh` runs the host, `wai-remote-host`,
which captures, encodes and publishes the screen and applies the inputs it is handed, each signed.

- **Build.** Nothing to build: `wai dev` serves the room's page, and `host.sh` runs the host from
  the installed binaries.
- **Run.** `wai dev`, then in a second terminal `sh host.sh --pattern` (a test pattern; without
  `--pattern`, the display itself); open `http://127.0.0.1:8080/` and press **Join**.
- **Test.** `wai dev --check` checks the room's stack through its origin and stops. A session:
  `sh host.sh --pattern --seconds 20 --record session.json` writes its records, and the
  independent verifier in the WAI repository checks them,
  `python3 -I wai/live-conformance/remote_desktop_verify.py --room session.json`.
- **Conform.** Control passes only by a grant exchange the host proves its key for; inputs outside
  a controller's classes are refused. Never hand control without it.
- `host.key` is the host's private key (made by `host.sh`, mode 0600), a secret: never commit it;
  `.gitignore` keeps it out, with `.wai/`, where `wai dev` keeps its development keys.
- `wai.json` is the project file: `wai dev` takes its defaults from its `dev` block, and its
  `$schema` names the schema editors validate it with. Keep `name` a lowercase DNS label.
- WAI's tools for a coding agent: `wai mcp` (`wai setup-agent` registers it).