The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
Teach OS agents the PC and T2 platform boundaries (#849)
Deec6ddd85367ae
diff --git a/os/README.md b/os/README.mdindex 2ed4a5e37..0777d5473 100644--- a/os/README.md+++ b/os/README.md@@ -71,7 +71,9 @@ payload-location fix.but no Mac model family has completed physical validation. Selected Broadcomdrivers are available offline, and supported SPI keyboard controllers are includedfor encrypted unlock; VM checks do not prove physical Wi-Fi or keyboard support.-T2 Macs need separate integration. Apple Silicon and Raspberry Pi do not have+T2 Macs have a separate [experimental image](platforms/apple-t2/README.md) with+VM-verified installation, firmware preservation and offline recovery; physical+hardware and automatic T2 kernel upgrades remain unverified. Apple Silicon and Raspberry Pi do not haveinstallable Harness images yet. See the [hardware targets](DEVELOPMENT.md#mac-support-targets)for requirements and remaining work.diff --git a/os/root/usr/share/harness-os/AGENTS.md b/os/root/usr/share/harness-os/AGENTS.mdindex d9ae95338..9e5820b1b 100644--- a/os/root/usr/share/harness-os/AGENTS.md+++ b/os/root/usr/share/harness-os/AGENTS.md@@ -18,7 +18,11 @@ is required.deferred until the user chooses it; Done keeps working processes alive.Do not replace `/usr/lib/harness` manually or enable the CLI's independentdaemon handoff updater: this OS supervises activation with systemd.-- This is Arch Linux with systemd, the LTS kernel, labwc, foot and Chromium.+- This is Arch Linux with systemd, labwc, foot and Chromium. Read+ `/etc/harness-platform.json` before choosing kernel or driver packages: `pc`+ uses `linux-lts`; the experimental `apple-t2` image uses the pinned `linux-t2`.+ Older PC installations have no platform file. Confirm the running kernel with+ `uname -r` and `/usr/lib/modules/$(uname -r)/pkgbase`.- Use the ordinary package manager; no private package ecosystem is required.On the live USB, `sudo systemctl start harness-keyring` waits for its one-timekey setup before the first package installation. Installed systems finish that@@ -70,13 +74,28 @@ is required.- `harness hardware` reports the model, CPU baseline, PCI devices, bound driversand backlights. It does not collect serial numbers, Wi-Fi names, MAC addressesor passwords. Use actual device IDs when diagnosing hardware.-- The USB carries a prebuilt wl module and signed offline packages for selected+- The PC USB carries a prebuilt wl module and signed offline packages for selectedBCM4331/BCM4360 radios. The installer adds DKMS and matching LTS headers onlywhere needed, so future kernel upgrades can rebuild the driver. Other Broadcomfamilies keep their native drivers. Do not apply a blanket Broadcom blacklist.Driver build/load checks are not evidence of physical radio or suspend support.+- The experimental T2 image uses its own kernel and early input modules. Do not+ replace them with `linux-lts`, `broadcom-wl-dkms` or PC kernel modules. Its+ required kernel and module identities are in+ `/usr/share/harness-os/apple-t2/kernel.json`; actual installed packages and+ `modinfo` must agree. A VM boot does not establish physical Mac support.+- T2 Wi-Fi and Bluetooth need that Mac's Apple firmware. Installation preserves+ a verified local export before erasing the disk and stops if it cannot do so.+ The private copy is `/var/lib/harness-os/apple-firmware.tar`, with its model+ and checksum in `/var/lib/harness-os/install.json`; the reinstall copy is+ `/boot/harness-apple-firmware.tar`. Firmware package hooks restore this data+ automatically. Retain both copies; never upload them as diagnostic attachments.+ Use the T2 USB for offline recovery. The current T2 kernel stays pinned during+ ordinary Arch updates; a changed kernel pin requires a separately verified+ upgrade path. Do not bypass the updater's platform checks or add a moving+ kernel repository to work around a refused update.- Ethernet uses NetworkManager automatically. For Wi-Fi, use- `hn-os wifi`, which opens NetworkManager’s keyboard interface.+ `Super+w` or `hn-os wifi`, which opens the Harness Wi-Fi form.Keep passwords out of shell arguments and transcripts.- Audio uses PipeWire. Clipboard uses `wl-copy` and `wl-paste`.- npm installs into `~/.local`. The initial npm configuration permits the vendor@@ -84,8 +103,8 @@ is required.an install script, approve that package explicitly; keep npm's other defaults.- `Super+b` opens/focuses Chromium or returns to hn; `Super+Enter` focuses hn;`Super+l` locks the screen. `sudo systemctl poweroff` shuts down cleanly.-- On supported NVIDIA Turing and newer GPUs, including RTX 4090/5090 and RTX 6000- generations, the LTS-kernel packages are `nvidia-open-lts nvidia-utils`.+- On the PC image, the packages for supported NVIDIA Turing and newer GPUs are+ `nvidia-open-lts nvidia-utils`, including RTX 4090/5090 and RTX 6000 generations.New USB images carrying the NVIDIA bundle install them offline when the exactGPU IDs match the bundled support table. Check `pacman -Q` and`/var/lib/harness-os/hardware.json` before installing anything. Other machines