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
Rename device/esp32-circle to device/harness: the paths inside it too
0xdiego25eba2a265c657
diff --git a/device/harness/README.md b/device/harness/README.mdindex ab7f0e3c8..382c59bc5 100644--- a/device/harness/README.md+++ b/device/harness/README.md@@ -42,7 +42,7 @@ fall back to `:8085`).## Build & flash```bash-cd device/esp32-circle+cd device/harnessidf.py set-target esp32s3idf.py buildidf.py -p <PORT> flash monitor # e.g. -p /dev/cu.usbmodem1101diff --git a/device/harness/RELEASE.md b/device/harness/RELEASE.mdindex d4b1025f0..b8ac8279d 100644--- a/device/harness/RELEASE.md+++ b/device/harness/RELEASE.md@@ -53,8 +53,8 @@ make upload-circle ARGS="--no-bump" # keep version.txt as-is, build + uploadmake upload-circle ARGS="--no-commit" # don't git-commit the version.txt bump```-`make upload-circle` just runs `device/esp32-circle/scripts/upload-firmware.sh` (a full pipeline: bump-`version.txt` → `idf.py -C device/esp32-circle build` → upload `.bin` + merge `metadata.json` to GCS → **git+`make upload-circle` just runs `device/harness/scripts/upload-firmware.sh` (a full pipeline: bump+`version.txt` → `idf.py -C device/harness build` → upload `.bin` + merge `metadata.json` to GCS → **gitcommit + push** the `version.txt` bump). You can call the script directly too. It auto-sources the ESP-IDF envfrom `IDF_PATH` or `~/esp/esp-idf`; if a step fails before publishing, it reverts the `version.txt`bump so a failed run leaves no dangling version.@@ -66,9 +66,9 @@ devices can download without credentials.Notes:- The version baked **into the binary** (`esp_app_desc.version`) and the version in the **manifest**- both come from the same `device/esp32-circle/version.txt`, so the device's equality check is exact. Keep them+ both come from the same `device/harness/version.txt`, so the device's equality check is exact. Keep themin sync by only ever changing the version there.-- If a rebuild doesn't seem to pick up the new version, `touch device/esp32-circle/version.txt` before step 3+- If a rebuild doesn't seem to pick up the new version, `touch device/harness/version.txt` before step 3to force the app-descriptor to regenerate.- GCS layout (all overridable via env in `scripts/upload-firmware.sh`): bucket`s3-autonomous-upgrade-3`, binary `harness/esp32/bin/<version>.bin`, manifestdiff --git a/device/harness/design/agent-switcher-local-remote.html b/device/harness/design/agent-switcher-local-remote.htmlindex d9522a31d..8c6bb24ed 100644--- a/device/harness/design/agent-switcher-local-remote.html+++ b/device/harness/design/agent-switcher-local-remote.html@@ -5,7 +5,7 @@<meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Agent switcher — telling local from remote · design options</title><style>- /* ---- Design tokens (mirror device/esp32-circle/main/ui/ui_screens.c) ---- */+ /* ---- Design tokens (mirror device/harness/main/ui/ui_screens.c) ---- */:root{--bg:#000000; --fg:#eaeaf0; --muted:#8a8a99; --card:#16161c;--accent:#5b8cff; --green:#35c46a; --voice:#00ff2f; --dotoff:#4c4c4c;diff --git a/device/harness/design/ui-mockups.html b/device/harness/design/ui-mockups.htmlindex 21f18bb81..e36f307c6 100644--- a/device/harness/design/ui-mockups.html+++ b/device/harness/design/ui-mockups.html@@ -5,7 +5,7 @@<meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Interns Commander — Device UI (current state) · design reference</title><style>- /* ---- Design tokens (mirror device/esp32-circle/main/ui/ui_screens.c) ---- */+ /* ---- Design tokens (mirror device/harness/main/ui/ui_screens.c) ---- */:root{--bg:#000000; --fg:#eaeaf0; --muted:#8a8a99; --card:#16161c; --card-press:#24242e;--accent:#5b8cff; --green:#35c46a; --red:#ff5a5a; --yellow:#f0b429; --orange:#ff8a4c;@@ -138,7 +138,7 @@<h1>Interns Commander — Device UI (current state)</h1><p><b>Round 466×466 AMOLED.</b> This is a <b>faithful reference of the UI as it ships today</b> — everystage, drawn with the real colors, fonts, sizes and layout pulled from- <code>device/esp32-circle/main/ui/ui_screens.c</code>. It is the starting point for the design team to+ <code>device/harness/main/ui/ui_screens.c</code>. It is the starting point for the design team to<b>polish</b>; nothing here is a proposal yet.</p><p>Each frame is authored at true 466px and scaled to 300px for display, so proportions are exact. The<b>status bar</b> (top) and <b>page dots</b> (bottom) are persistent overlays shown on in-session screens.diff --git a/device/harness/docs/INTERNAL_RAM_OPTIMIZATION.md b/device/harness/docs/INTERNAL_RAM_OPTIMIZATION.mdindex 0d7c2f094..fec0a6034 100644--- a/device/harness/docs/INTERNAL_RAM_OPTIMIZATION.md+++ b/device/harness/docs/INTERNAL_RAM_OPTIMIZATION.md@@ -81,7 +81,7 @@ implied by the RAM-focused tests.Build command:```bash-cd device/esp32-circle+cd device/harnesssource ~/esp/esp-idf/export.shidf.py -B build-arm buildidf.py -B build-arm sizediff --git a/device/harness/main/idf_component.yml b/device/harness/main/idf_component.ymlindex 2aa7ddc95..a410f3724 100644--- a/device/harness/main/idf_component.yml+++ b/device/harness/main/idf_component.yml@@ -18,6 +18,6 @@ dependencies:# tcp_transport does not provide (no HTTP-redirect support).espressif/esp_websocket_client: "~1.2.0"# libsodium — the E2EE crypto stack (Ed25519, X25519, ristretto255 CPace, ChaCha20-Poly1305,- # SHA-2, HKDF/HMAC). Backs device/esp32-circle/main/e2ee/e2ee_core.c (byte-identical twin of the web/adapter+ # SHA-2, HKDF/HMAC). Backs device/harness/main/e2ee/e2ee_core.c (byte-identical twin of the web/adapter# TS core). The Espressif port wires randombytes to the hardware RNG. See e2ee_core.h.espressif/libsodium: "^1.0.20"diff --git a/device/harness/screen.html b/device/harness/screen.htmlindex 1dbda6839..a29a0ff44 100644--- a/device/harness/screen.html+++ b/device/harness/screen.html@@ -402,6 +402,6 @@</section><footer>- Commander device UI — device/esp32-circle/main/ui/ui_screens.c · round 466×466 CO5300 AMOLED · rendered from the live palette & type scale.+ Commander device UI — device/harness/main/ui/ui_screens.c · round 466×466 CO5300 AMOLED · rendered from the live palette & type scale.</footer></div>diff --git a/device/harness/scripts/gen_cable_vectors.py b/device/harness/scripts/gen_cable_vectors.pyindex 48b0231ee..89629b8dd 100644--- a/device/harness/scripts/gen_cable_vectors.py+++ b/device/harness/scripts/gen_cable_vectors.py@@ -1,8 +1,8 @@#!/usr/bin/env python3"""Generate the shared framing vectors for the USB cable link.- device/esp32-circle/scripts/gen_cable_vectors.py # writes test/vectors/cable_frame.txt- device/esp32-circle/scripts/gen_cable_vectors.py --check # fails if the file on disk differs+ device/harness/scripts/gen_cable_vectors.py # writes test/vectors/cable_frame.txt+ device/harness/scripts/gen_cable_vectors.py --check # fails if the file on disk differsA THIRD implementation, written from the format description in main/cable_frame.h and from nothingelse. That is the entire point: the firmware (C) and the daemon (TypeScript, in the autonomous-harness@@ -136,7 +136,7 @@ def stream_cases():def render() -> str:out = ["# Shared framing vectors for the harness USB cable link.",- "# Generated by device/esp32-circle/scripts/gen_cable_vectors.py — a third implementation, written",+ "# Generated by device/harness/scripts/gen_cable_vectors.py — a third implementation, written","# from main/cable_frame.h's format description and from neither half's code. Do not hand-edit.","#","# encode <name> <type> <payload-hex> <frame-hex>",diff --git a/device/harness/scripts/upload-firmware.sh b/device/harness/scripts/upload-firmware.shindex 01135a0a6..e8568b285 100755--- a/device/harness/scripts/upload-firmware.sh+++ b/device/harness/scripts/upload-firmware.sh@@ -19,7 +19,7 @@# must be public-read so devices can download without credentials. `idf.py` on PATH (or IDF_PATH set).set -euo pipefail-HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" # device/esp32-circle+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" # device/harnessVER_FILE="$HERE/version.txt"# A DEDICATED prod build dir + DEVICE_FORCE_PROD so a published binary is always production (ignores any# local provisioned_config.h) WITHOUT moving the header, and without clobbering the interactive `build/`@@ -150,7 +150,7 @@ if [ "$DO_BUILD" -eq 1 ]; then# 10 KiB landed, producing firmware that crashed mid-OTA and could not update itself.## Deleting it costs a reconfigure (~10s) per release and makes the published binary a function of the- # tracked defaults alone. The developer's interactive device/esp32-circle/sdkconfig is left untouched.+ # tracked defaults alone. The developer's interactive device/harness/sdkconfig is left untouched.RELEASE_SDKCONFIG="$BUILD_DIR/sdkconfig.release"rm -f "$RELEASE_SDKCONFIG"echo ">> building… (prod: -DDEVICE_FORCE_PROD=1, build dir $BUILD_DIR, fresh config from sdkconfig.defaults)"diff --git a/device/harness/test/run.sh b/device/harness/test/run.shindex 81f21dcc5..06adcbdc0 100755--- a/device/harness/test/run.sh+++ b/device/harness/test/run.sh@@ -1,7 +1,7 @@#!/usr/bin/env bash# Host tests for the parts of the firmware that do not need the board.#-# device/esp32-circle/test/run.sh+# device/harness/test/run.sh## No ESP-IDF, no flash cycle, no cable: cable_frame.c compiles with a plain compiler on purpose, so the# framing both halves of the link depend on can be checked in milliseconds. Run it before touching eitherdiff --git a/device/harness/test/test_cable_frame.c b/device/harness/test/test_cable_frame.cindex 00153cf8e..bb17670e0 100644--- a/device/harness/test/test_cable_frame.c+++ b/device/harness/test/test_cable_frame.c@@ -1,6 +1,6 @@// Runs the shared framing vectors against the firmware's own decoder, on a laptop.//-// device/esp32-circle/test/run.sh+// device/harness/test/run.sh//// This is the C half of the agreement described in main/cable_frame.h: the daemon's TypeScript decoder// asserts against the same test/vectors/cable_frame.txt, generated by a third implementation. Nothing isdiff --git a/device/harness/test/test_cable_machines.c b/device/harness/test/test_cable_machines.cindex aef6257d8..37e70f130 100644--- a/device/harness/test/test_cable_machines.c+++ b/device/harness/test/test_cable_machines.c@@ -1,6 +1,6 @@// The machine-wheel ingest gate, on a laptop.//-// device/esp32-circle/test/run.sh+// device/harness/test/run.sh//// What is under test is one question — "did anything actually change?" — and every case here is a way of// getting that wrong that would look completely normal on the screen. An over-eager `true` costs a wheeldiff --git a/device/harness/test/vectors/cable_frame.txt b/device/harness/test/vectors/cable_frame.txtindex 00ffa7838..71da64ac0 100644--- a/device/harness/test/vectors/cable_frame.txt+++ b/device/harness/test/vectors/cable_frame.txt@@ -1,5 +1,5 @@# Shared framing vectors for the harness USB cable link.-# Generated by device/esp32-circle/scripts/gen_cable_vectors.py — a third implementation, written+# Generated by device/harness/scripts/gen_cable_vectors.py — a third implementation, written# from main/cable_frame.h's format description and from neither half's code. Do not hand-edit.## encode <name> <type> <payload-hex> <frame-hex>diff --git a/device/harness/tools/generate_engine_icons.py b/device/harness/tools/generate_engine_icons.pyindex 00be825d5..56a12bac8 100644--- a/device/harness/tools/generate_engine_icons.py+++ b/device/harness/tools/generate_engine_icons.py@@ -18,7 +18,7 @@ REPO_ROOT = Path(__file__).resolve().parents[3]# to be pointed at a checkout of it:## HARNESS_ENGINE_ICONS=~/src/autonomous-code/apps/web/public/engine-icons \-# python3 device/esp32-circle/tools/generate_engine_icons.py+# python3 device/harness/tools/generate_engine_icons.py## The SHA-256 table below is what makes that safe to do across two repos: an icon# that has changed on the web side fails the check rather than silently@@ -27,7 +27,7 @@ ASSET_DIR = Path(os.environ.get("HARNESS_ENGINE_ICONS")or REPO_ROOT / "../autonomous-code/apps/web/public/engine-icons").expanduser()-TARGET = REPO_ROOT / "device/esp32-circle/main/ui/icons_engine.c"+TARGET = REPO_ROOT / "device/harness/main/ui/icons_engine.c"ICON_SIZE = 20EXPECTED_SHA256 = {"codex.png": "8e82b26c98a10e45798ce48124515720657f7735fb8d0853b3f087eaa8a6b74e",