Skip to content

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.

Rename device/esp32-circle to device/harness: the paths inside it too

0xdiego25eba2a265c657
diff --git a/device/harness/README.md b/device/harness/README.md
index 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/harness
idf.py set-target esp32s3
idf.py build
idf.py -p <PORT> flash monitor # e.g. -p /dev/cu.usbmodem1101
diff --git a/device/harness/RELEASE.md b/device/harness/RELEASE.md
index 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 + upload
make 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 → **git
commit + push** the `version.txt` bump). You can call the script directly too. It auto-sources the ESP-IDF env
from `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 them
in 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 3
to 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`, manifest
diff --git a/device/harness/design/agent-switcher-local-remote.html b/device/harness/design/agent-switcher-local-remote.html
index 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.html
index 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> — every
stage, 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.md
index 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/harness
source ~/esp/esp-idf/export.sh
idf.py -B build-arm build
idf.py -B build-arm size
diff --git a/device/harness/main/idf_component.yml b/device/harness/main/idf_component.yml
index 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.html
index 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 &amp; type scale.
+ Commander device UI — device/harness/main/ui/ui_screens.c · round 466×466 CO5300 AMOLED · rendered from the live palette &amp; type scale.
</footer>
</div>
diff --git a/device/harness/scripts/gen_cable_vectors.py b/device/harness/scripts/gen_cable_vectors.py
index 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 differs
A THIRD implementation, written from the format description in main/cable_frame.h and from nothing
else. 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.sh
index 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/harness
VER_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.sh
index 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 either
diff --git a/device/harness/test/test_cable_frame.c b/device/harness/test/test_cable_frame.c
index 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 is
diff --git a/device/harness/test/test_cable_machines.c b/device/harness/test/test_cable_machines.c
index 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 wheel
diff --git a/device/harness/test/vectors/cable_frame.txt b/device/harness/test/vectors/cable_frame.txt
index 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.py
index 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 = 20
EXPECTED_SHA256 = {
"codex.png": "8e82b26c98a10e45798ce48124515720657f7735fb8d0853b3f087eaa8a6b74e",