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/ to devices/

0xdiego25e6a433e85bcc
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 86f458845..9a86c1168 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -148,7 +148,7 @@ read what you submit and run the example yourself.
| Add an API provider | [Provider guide](provider/README.md) |
| Improve terminal behavior, shortcuts, or accessibility | [Development guide](docs/development.md), [keyboard guide](docs/keyboard.md) |
| Help with Linux or Windows compatibility | [Development guide](docs/development.md#platform-support) |
-| Support another hardware board | [Firmware guide](device/harness-device/firmware/README.md) |
+| Support another hardware board | [Firmware guide](devices/harness-device/firmware/README.md) |
| Fix documentation or report a bug | A small PR, or an issue with steps to reproduce |
For a new engine, multiplexer, or a change to a shared protocol, open an issue first so we can agree
diff --git a/Makefile b/Makefile
index cac9e173a..2f6dfa5ac 100644
--- a/Makefile
+++ b/Makefile
@@ -69,16 +69,16 @@ remote-machine:
## NOT a tag-triggered release like the three above, and deliberately so: this builds with a local
## ESP-IDF toolchain and writes straight to the GCS bucket every running dial polls, so it needs an
## authenticated `gcloud storage` and a sourced IDF env on the machine that runs it. There is no CI runner with
-## a board attached to check the result. See device/harness-device/firmware/RELEASE.md.
+## a board attached to check the result. See devices/harness-device/firmware/RELEASE.md.
##
## ARGS="--dry-run" to preview, ARGS="X.Y.Z" for an explicit version, ARGS="--no-bump" to rebuild and
## upload what version.txt already says.
upload-circle:
- bash device/harness-device/firmware/scripts/upload-firmware.sh $(ARGS)
+ bash devices/harness-device/firmware/scripts/upload-firmware.sh $(ARGS)
## device-test: the firmware's host-side unit tests — frame codec, machine list, carousel ring.
##
## Plain `cc` on the host, no board and no ESP-IDF: the parts worth testing here are arithmetic and
## parsing, and a test that needed hardware attached is a test nobody runs.
device-test:
- bash device/harness-device/firmware/test/run.sh
+ bash devices/harness-device/firmware/test/run.sh
diff --git a/README.md b/README.md
index 4c81957ef..7ce80e3ab 100644
--- a/README.md
+++ b/README.md
@@ -166,12 +166,12 @@ The [architecture docs](docs/architecture.md) describe transport, identity, and
## Device firmware
-[`device/harness-device/firmware/`](device/harness-device/firmware/) contains ESP32-S3 firmware for a round USB companion display.
+[`devices/harness-device/firmware/`](devices/harness-device/firmware/) contains ESP32-S3 firmware for a round USB companion display.
It shows agent status and supports responses and voice input through the host daemon.
The device connects over USB; it doesn't need Wi-Fi credentials.
Build and flash it onto a supported board, or add a board port. Schematics and enclosure designs
-are not in the repository yet. The [hardware guide](device/harness-device/firmware/README.md) lists the current
+are not in the repository yet. The [hardware guide](devices/harness-device/firmware/README.md) lists the current
boards and build commands.
https://github.com/user-attachments/assets/97848065-61c6-40df-be66-a8247f69aa4c
@@ -197,7 +197,7 @@ cli/ TypeScript CLI, daemon, engine adapters, and package runtime
backend/ Relay and control plane
store/ Harnesses, shared viewers, registry, examples, and package spec
provider/ Provider API contract, implementations, and conformance tests
-device/ Device firmware
+devices/ Device firmware
```
- [Development and testing](docs/development.md) · [Extension points](docs/extending.md)
diff --git a/cli/scripts/sync-cable-vectors.sh b/cli/scripts/sync-cable-vectors.sh
index e549e1cf9..3a6685345 100755
--- a/cli/scripts/sync-cable-vectors.sh
+++ b/cli/scripts/sync-cable-vectors.sh
@@ -4,7 +4,7 @@
# scripts/sync-cable-vectors.sh # copy in, report whether anything changed
# scripts/sync-cable-vectors.sh --check # fail if the copy is stale (for CI, when the source is there)
#
-# The vectors are generated by device/harness-device/firmware/scripts/gen_cable_vectors.py — a third implementation
+# The vectors are generated by devices/harness-device/firmware/scripts/gen_cable_vectors.py — a third implementation
# written from the format description, so neither the firmware's decoder nor this repository's blesses its
# own misreading. That only holds while the copy here is current: a stale copy lets both suites pass while
# the real cable disagrees.
@@ -15,7 +15,7 @@ set -euo pipefail
here="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
dest="$here/../src/cable/vectors/cable_frame.txt"
-src="$here/../../device/harness-device/firmware/test/vectors/cable_frame.txt"
+src="$here/../../devices/harness-device/firmware/test/vectors/cable_frame.txt"
if [ ! -f "$src" ]; then
echo "source vectors not found: $src"
diff --git a/cli/src/cable/cableFrame.spec.ts b/cli/src/cable/cableFrame.spec.ts
index ef356745f..2c961d9b0 100644
--- a/cli/src/cable/cableFrame.spec.ts
+++ b/cli/src/cable/cableFrame.spec.ts
@@ -1,7 +1,7 @@
// The TypeScript half of the framing agreement — see cableFrame.ts.
//
// The vectors in vectors/cable_frame.txt are a COPY. They are generated by
-// device/harness-device/firmware/scripts/gen_cable_vectors.py, an implementation that is neither this one nor the
+// devices/harness-device/firmware/scripts/gen_cable_vectors.py, an implementation that is neither this one nor the
// firmware's, and the firmware's own host test asserts against the same file. Refresh the
// copy with scripts/sync-cable-vectors.sh; a stale copy makes this suite pass while the real link
// disagrees, which is the failure this whole arrangement exists to prevent.
diff --git a/cli/src/cable/cableFrame.ts b/cli/src/cable/cableFrame.ts
index f766484da..c52642dba 100644
--- a/cli/src/cable/cableFrame.ts
+++ b/cli/src/cable/cableFrame.ts
@@ -1,7 +1,7 @@
// Framing for the USB link to the dial — turns a byte stream into messages, and messages back into bytes.
//
-// The mirror image of device/harness-device/firmware/main/cable_frame.c. Both halves are checked against ONE shared
-// vector file (vectors/cable_frame.txt here, generated by device/harness-device/firmware/scripts/gen_cable_vectors.py from
+// The mirror image of devices/harness-device/firmware/main/cable_frame.c. Both halves are checked against ONE shared
+// vector file (vectors/cable_frame.txt here, generated by devices/harness-device/firmware/scripts/gen_cable_vectors.py from
// the format description rather than from either implementation), so a shared misreading shows up as a
// disagreement instead of being blessed by both. The two halves are written in two languages and share no
// code; the vectors are the only thing they share.
diff --git a/cli/src/cable/cableSession.ts b/cli/src/cable/cableSession.ts
index a6c5b4aee..caadb0161 100644
--- a/cli/src/cable/cableSession.ts
+++ b/cli/src/cable/cableSession.ts
@@ -1,6 +1,6 @@
// The message layer: what the daemon and the dial SAY to each other, on top of the bytes serial.ts moves.
//
-// Written twice — here and in device/harness-device/firmware/main/cable_client.c — with no shared code, because one half
+// Written twice — here and in devices/harness-device/firmware/main/cable_client.c — with no shared code, because one half
// is TypeScript on a laptop and the other is C on an MCU. The framing underneath agrees by shared vectors;
// this layer agrees by docs/cable-protocol.md and by being small enough to read in one sitting.
//
diff --git a/cli/src/cable/vectors/cable_frame.txt b/cli/src/cable/vectors/cable_frame.txt
index 3f71defe6..3887114d3 100644
--- a/cli/src/cable/vectors/cable_frame.txt
+++ b/cli/src/cable/vectors/cable_frame.txt
@@ -1,5 +1,5 @@
# Shared framing vectors for the harness USB cable link.
-# Generated by device/harness-device/firmware/scripts/gen_cable_vectors.py — a third implementation, written
+# Generated by devices/harness-device/firmware/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-device/firmware/.gitignore b/devices/harness-device/firmware/.gitignore
similarity index 100%
rename from device/harness-device/firmware/.gitignore
rename to devices/harness-device/firmware/.gitignore
diff --git a/device/harness-device/firmware/CMakeLists.txt b/devices/harness-device/firmware/CMakeLists.txt
similarity index 100%
rename from device/harness-device/firmware/CMakeLists.txt
rename to devices/harness-device/firmware/CMakeLists.txt
diff --git a/device/harness-device/firmware/README.md b/devices/harness-device/firmware/README.md
similarity index 98%
rename from device/harness-device/firmware/README.md
rename to devices/harness-device/firmware/README.md
index 42d56a273..cbac0da34 100644
--- a/device/harness-device/firmware/README.md
+++ b/devices/harness-device/firmware/README.md
@@ -30,7 +30,7 @@ for the shared pin definitions. Other ESP32 boards need a port; matching the MCU
Install and activate ESP-IDF 5.5 or newer. From the repository root:
```bash
-cd device/harness-device/firmware
+cd devices/harness-device/firmware
idf.py set-target esp32s3
idf.py build
idf.py -p PORT flash monitor
diff --git a/device/harness-device/firmware/RELEASE.md b/devices/harness-device/firmware/RELEASE.md
similarity index 95%
rename from device/harness-device/firmware/RELEASE.md
rename to devices/harness-device/firmware/RELEASE.md
index 7984a9952..90dc50937 100644
--- a/device/harness-device/firmware/RELEASE.md
+++ b/devices/harness-device/firmware/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/harness-device/firmware/scripts/upload-firmware.sh` (a full pipeline: bump
-`version.txt` → `idf.py -C device/harness-device/firmware build` → upload `.bin` + merge `metadata.json` to GCS → **git
+`make upload-circle` just runs `devices/harness-device/firmware/scripts/upload-firmware.sh` (a full pipeline: bump
+`version.txt` → `idf.py -C devices/harness-device/firmware 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/harness-device/firmware/version.txt`, so the device's equality check is exact. Keep them
+ both come from the same `devices/harness-device/firmware/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/harness-device/firmware/version.txt` before step 3
+- If a rebuild doesn't seem to pick up the new version, `touch devices/harness-device/firmware/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-device/firmware/device-stages.html b/devices/harness-device/firmware/device-stages.html
similarity index 100%
rename from device/harness-device/firmware/device-stages.html
rename to devices/harness-device/firmware/device-stages.html
diff --git a/device/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.md b/devices/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.md
similarity index 99%
rename from device/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.md
rename to devices/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.md
index e4cf11bd9..9f221bf52 100644
--- a/device/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.md
+++ b/devices/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.md
@@ -81,7 +81,7 @@ implied by the RAM-focused tests.
Build command:
```bash
-cd device/harness-device/firmware
+cd devices/harness-device/firmware
source ~/esp/esp-idf/export.sh
idf.py -B build-arm build
idf.py -B build-arm size
diff --git a/device/harness-device/firmware/docs/UI_FLOWS.md b/devices/harness-device/firmware/docs/UI_FLOWS.md
similarity index 100%
rename from device/harness-device/firmware/docs/UI_FLOWS.md
rename to devices/harness-device/firmware/docs/UI_FLOWS.md
diff --git a/device/harness-device/firmware/docs/UI_REDESIGN.md b/devices/harness-device/firmware/docs/UI_REDESIGN.md
similarity index 100%
rename from device/harness-device/firmware/docs/UI_REDESIGN.md
rename to devices/harness-device/firmware/docs/UI_REDESIGN.md
diff --git a/device/harness-device/firmware/fonts/Geist-Medium.ttf b/devices/harness-device/firmware/fonts/Geist-Medium.ttf
similarity index 100%
rename from device/harness-device/firmware/fonts/Geist-Medium.ttf
rename to devices/harness-device/firmware/fonts/Geist-Medium.ttf
diff --git a/device/harness-device/firmware/fonts/Geist-Regular.ttf b/devices/harness-device/firmware/fonts/Geist-Regular.ttf
similarity index 100%
rename from device/harness-device/firmware/fonts/Geist-Regular.ttf
rename to devices/harness-device/firmware/fonts/Geist-Regular.ttf
diff --git a/device/harness-device/firmware/fonts/Geist-SemiBold.ttf b/devices/harness-device/firmware/fonts/Geist-SemiBold.ttf
similarity index 100%
rename from device/harness-device/firmware/fonts/Geist-SemiBold.ttf
rename to devices/harness-device/firmware/fonts/Geist-SemiBold.ttf
diff --git a/device/harness-device/firmware/fonts/OFL.txt b/devices/harness-device/firmware/fonts/OFL.txt
similarity index 100%
rename from device/harness-device/firmware/fonts/OFL.txt
rename to devices/harness-device/firmware/fonts/OFL.txt
diff --git a/device/harness-device/firmware/main/CMakeLists.txt b/devices/harness-device/firmware/main/CMakeLists.txt
similarity index 100%
rename from device/harness-device/firmware/main/CMakeLists.txt
rename to devices/harness-device/firmware/main/CMakeLists.txt
diff --git a/device/harness-device/firmware/main/app_main.c b/devices/harness-device/firmware/main/app_main.c
similarity index 100%
rename from device/harness-device/firmware/main/app_main.c
rename to devices/harness-device/firmware/main/app_main.c
diff --git a/device/harness-device/firmware/main/audio_capture.c b/devices/harness-device/firmware/main/audio_capture.c
similarity index 100%
rename from device/harness-device/firmware/main/audio_capture.c
rename to devices/harness-device/firmware/main/audio_capture.c
diff --git a/device/harness-device/firmware/main/audio_capture.h b/devices/harness-device/firmware/main/audio_capture.h
similarity index 100%
rename from device/harness-device/firmware/main/audio_capture.h
rename to devices/harness-device/firmware/main/audio_capture.h
diff --git a/device/harness-device/firmware/main/audio_client.c b/devices/harness-device/firmware/main/audio_client.c
similarity index 100%
rename from device/harness-device/firmware/main/audio_client.c
rename to devices/harness-device/firmware/main/audio_client.c
diff --git a/device/harness-device/firmware/main/audio_client.h b/devices/harness-device/firmware/main/audio_client.h
similarity index 100%
rename from device/harness-device/firmware/main/audio_client.h
rename to devices/harness-device/firmware/main/audio_client.h
diff --git a/device/harness-device/firmware/main/board/board.c b/devices/harness-device/firmware/main/board/board.c
similarity index 100%
rename from device/harness-device/firmware/main/board/board.c
rename to devices/harness-device/firmware/main/board/board.c
diff --git a/device/harness-device/firmware/main/board/board.h b/devices/harness-device/firmware/main/board/board.h
similarity index 100%
rename from device/harness-device/firmware/main/board/board.h
rename to devices/harness-device/firmware/main/board/board.h
diff --git a/device/harness-device/firmware/main/board/board_i2c.c b/devices/harness-device/firmware/main/board/board_i2c.c
similarity index 100%
rename from device/harness-device/firmware/main/board/board_i2c.c
rename to devices/harness-device/firmware/main/board/board_i2c.c
diff --git a/device/harness-device/firmware/main/board/board_i2c.h b/devices/harness-device/firmware/main/board/board_i2c.h
similarity index 100%
rename from device/harness-device/firmware/main/board/board_i2c.h
rename to devices/harness-device/firmware/main/board/board_i2c.h
diff --git a/device/harness-device/firmware/main/board/board_pins.h b/devices/harness-device/firmware/main/board/board_pins.h
similarity index 100%
rename from device/harness-device/firmware/main/board/board_pins.h
rename to devices/harness-device/firmware/main/board/board_pins.h
diff --git a/device/harness-device/firmware/main/board/board_probe.c b/devices/harness-device/firmware/main/board/board_probe.c
similarity index 100%
rename from device/harness-device/firmware/main/board/board_probe.c
rename to devices/harness-device/firmware/main/board/board_probe.c
diff --git a/device/harness-device/firmware/main/board/board_probe.h b/devices/harness-device/firmware/main/board/board_probe.h
similarity index 100%
rename from device/harness-device/firmware/main/board/board_probe.h
rename to devices/harness-device/firmware/main/board/board_probe.h
diff --git a/device/harness-device/firmware/main/board/board_table.c b/devices/harness-device/firmware/main/board/board_table.c
similarity index 100%
rename from device/harness-device/firmware/main/board/board_table.c
rename to devices/harness-device/firmware/main/board/board_table.c
diff --git a/device/harness-device/firmware/main/board/power.c b/devices/harness-device/firmware/main/board/power.c
similarity index 100%
rename from device/harness-device/firmware/main/board/power.c
rename to devices/harness-device/firmware/main/board/power.c
diff --git a/device/harness-device/firmware/main/board/power.h b/devices/harness-device/firmware/main/board/power.h
similarity index 100%
rename from device/harness-device/firmware/main/board/power.h
rename to devices/harness-device/firmware/main/board/power.h
diff --git a/device/harness-device/firmware/main/cable_client.c b/devices/harness-device/firmware/main/cable_client.c
similarity index 100%
rename from device/harness-device/firmware/main/cable_client.c
rename to devices/harness-device/firmware/main/cable_client.c
diff --git a/device/harness-device/firmware/main/cable_client.h b/devices/harness-device/firmware/main/cable_client.h
similarity index 100%
rename from device/harness-device/firmware/main/cable_client.h
rename to devices/harness-device/firmware/main/cable_client.h
diff --git a/device/harness-device/firmware/main/cable_frame.c b/devices/harness-device/firmware/main/cable_frame.c
similarity index 100%
rename from device/harness-device/firmware/main/cable_frame.c
rename to devices/harness-device/firmware/main/cable_frame.c
diff --git a/device/harness-device/firmware/main/cable_frame.h b/devices/harness-device/firmware/main/cable_frame.h
similarity index 100%
rename from device/harness-device/firmware/main/cable_frame.h
rename to devices/harness-device/firmware/main/cable_frame.h
diff --git a/device/harness-device/firmware/main/cable_link.c b/devices/harness-device/firmware/main/cable_link.c
similarity index 100%
rename from device/harness-device/firmware/main/cable_link.c
rename to devices/harness-device/firmware/main/cable_link.c
diff --git a/device/harness-device/firmware/main/cable_link.h b/devices/harness-device/firmware/main/cable_link.h
similarity index 100%
rename from device/harness-device/firmware/main/cable_link.h
rename to devices/harness-device/firmware/main/cable_link.h
diff --git a/device/harness-device/firmware/main/cable_machines.c b/devices/harness-device/firmware/main/cable_machines.c
similarity index 100%
rename from device/harness-device/firmware/main/cable_machines.c
rename to devices/harness-device/firmware/main/cable_machines.c
diff --git a/device/harness-device/firmware/main/cable_machines.h b/devices/harness-device/firmware/main/cable_machines.h
similarity index 100%
rename from device/harness-device/firmware/main/cable_machines.h
rename to devices/harness-device/firmware/main/cable_machines.h
diff --git a/device/harness-device/firmware/main/config_store.c b/devices/harness-device/firmware/main/config_store.c
similarity index 100%
rename from device/harness-device/firmware/main/config_store.c
rename to devices/harness-device/firmware/main/config_store.c
diff --git a/device/harness-device/firmware/main/config_store.h b/devices/harness-device/firmware/main/config_store.h
similarity index 100%
rename from device/harness-device/firmware/main/config_store.h
rename to devices/harness-device/firmware/main/config_store.h
diff --git a/device/harness-device/firmware/main/device_mac.c b/devices/harness-device/firmware/main/device_mac.c
similarity index 100%
rename from device/harness-device/firmware/main/device_mac.c
rename to devices/harness-device/firmware/main/device_mac.c
diff --git a/device/harness-device/firmware/main/device_mac.h b/devices/harness-device/firmware/main/device_mac.h
similarity index 100%
rename from device/harness-device/firmware/main/device_mac.h
rename to devices/harness-device/firmware/main/device_mac.h
diff --git a/device/harness-device/firmware/main/fw_update.c b/devices/harness-device/firmware/main/fw_update.c
similarity index 100%
rename from device/harness-device/firmware/main/fw_update.c
rename to devices/harness-device/firmware/main/fw_update.c
diff --git a/device/harness-device/firmware/main/fw_update.h b/devices/harness-device/firmware/main/fw_update.h
similarity index 100%
rename from device/harness-device/firmware/main/fw_update.h
rename to devices/harness-device/firmware/main/fw_update.h
diff --git a/device/harness-device/firmware/main/idf_component.yml b/devices/harness-device/firmware/main/idf_component.yml
similarity index 91%
rename from device/harness-device/firmware/main/idf_component.yml
rename to devices/harness-device/firmware/main/idf_component.yml
index 2433917ea..f1537562d 100644
--- a/device/harness-device/firmware/main/idf_component.yml
+++ b/devices/harness-device/firmware/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/harness-device/firmware/main/e2ee/e2ee_core.c (byte-identical twin of the web/adapter
+ # SHA-2, HKDF/HMAC). Backs devices/harness-device/firmware/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-device/firmware/main/last_words.c b/devices/harness-device/firmware/main/last_words.c
similarity index 100%
rename from device/harness-device/firmware/main/last_words.c
rename to devices/harness-device/firmware/main/last_words.c
diff --git a/device/harness-device/firmware/main/last_words.h b/devices/harness-device/firmware/main/last_words.h
similarity index 100%
rename from device/harness-device/firmware/main/last_words.h
rename to devices/harness-device/firmware/main/last_words.h
diff --git a/device/harness-device/firmware/main/provisioned_config.h.example b/devices/harness-device/firmware/main/provisioned_config.h.example
similarity index 100%
rename from device/harness-device/firmware/main/provisioned_config.h.example
rename to devices/harness-device/firmware/main/provisioned_config.h.example
diff --git a/device/harness-device/firmware/main/ptt.c b/devices/harness-device/firmware/main/ptt.c
similarity index 100%
rename from device/harness-device/firmware/main/ptt.c
rename to devices/harness-device/firmware/main/ptt.c
diff --git a/device/harness-device/firmware/main/ptt.h b/devices/harness-device/firmware/main/ptt.h
similarity index 100%
rename from device/harness-device/firmware/main/ptt.h
rename to devices/harness-device/firmware/main/ptt.h
diff --git a/device/harness-device/firmware/main/ram_telemetry.c b/devices/harness-device/firmware/main/ram_telemetry.c
similarity index 100%
rename from device/harness-device/firmware/main/ram_telemetry.c
rename to devices/harness-device/firmware/main/ram_telemetry.c
diff --git a/device/harness-device/firmware/main/ram_telemetry.h b/devices/harness-device/firmware/main/ram_telemetry.h
similarity index 100%
rename from device/harness-device/firmware/main/ram_telemetry.h
rename to devices/harness-device/firmware/main/ram_telemetry.h
diff --git a/device/harness-device/firmware/main/ui/carousel_ring.c b/devices/harness-device/firmware/main/ui/carousel_ring.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/carousel_ring.c
rename to devices/harness-device/firmware/main/ui/carousel_ring.c
diff --git a/device/harness-device/firmware/main/ui/carousel_ring.h b/devices/harness-device/firmware/main/ui/carousel_ring.h
similarity index 100%
rename from device/harness-device/firmware/main/ui/carousel_ring.h
rename to devices/harness-device/firmware/main/ui/carousel_ring.h
diff --git a/device/harness-device/firmware/main/ui/display.c b/devices/harness-device/firmware/main/ui/display.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/display.c
rename to devices/harness-device/firmware/main/ui/display.c
diff --git a/device/harness-device/firmware/main/ui/display.h b/devices/harness-device/firmware/main/ui/display.h
similarity index 100%
rename from device/harness-device/firmware/main/ui/display.h
rename to devices/harness-device/firmware/main/ui/display.h
diff --git a/device/harness-device/firmware/main/ui/geist_med_28.c b/devices/harness-device/firmware/main/ui/geist_med_28.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_med_28.c
rename to devices/harness-device/firmware/main/ui/geist_med_28.c
diff --git a/device/harness-device/firmware/main/ui/geist_med_32.c b/devices/harness-device/firmware/main/ui/geist_med_32.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_med_32.c
rename to devices/harness-device/firmware/main/ui/geist_med_32.c
diff --git a/device/harness-device/firmware/main/ui/geist_med_38.c b/devices/harness-device/firmware/main/ui/geist_med_38.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_med_38.c
rename to devices/harness-device/firmware/main/ui/geist_med_38.c
diff --git a/device/harness-device/firmware/main/ui/geist_med_48.c b/devices/harness-device/firmware/main/ui/geist_med_48.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_med_48.c
rename to devices/harness-device/firmware/main/ui/geist_med_48.c
diff --git a/device/harness-device/firmware/main/ui/geist_med_64.c b/devices/harness-device/firmware/main/ui/geist_med_64.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_med_64.c
rename to devices/harness-device/firmware/main/ui/geist_med_64.c
diff --git a/device/harness-device/firmware/main/ui/geist_reg_16.c b/devices/harness-device/firmware/main/ui/geist_reg_16.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_reg_16.c
rename to devices/harness-device/firmware/main/ui/geist_reg_16.c
diff --git a/device/harness-device/firmware/main/ui/geist_reg_20.c b/devices/harness-device/firmware/main/ui/geist_reg_20.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_reg_20.c
rename to devices/harness-device/firmware/main/ui/geist_reg_20.c
diff --git a/device/harness-device/firmware/main/ui/geist_reg_24.c b/devices/harness-device/firmware/main/ui/geist_reg_24.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_reg_24.c
rename to devices/harness-device/firmware/main/ui/geist_reg_24.c
diff --git a/device/harness-device/firmware/main/ui/geist_reg_25.c b/devices/harness-device/firmware/main/ui/geist_reg_25.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_reg_25.c
rename to devices/harness-device/firmware/main/ui/geist_reg_25.c
diff --git a/device/harness-device/firmware/main/ui/geist_reg_32.c b/devices/harness-device/firmware/main/ui/geist_reg_32.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_reg_32.c
rename to devices/harness-device/firmware/main/ui/geist_reg_32.c
diff --git a/device/harness-device/firmware/main/ui/geist_reg_34.c b/devices/harness-device/firmware/main/ui/geist_reg_34.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_reg_34.c
rename to devices/harness-device/firmware/main/ui/geist_reg_34.c
diff --git a/device/harness-device/firmware/main/ui/geist_reg_38.c b/devices/harness-device/firmware/main/ui/geist_reg_38.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_reg_38.c
rename to devices/harness-device/firmware/main/ui/geist_reg_38.c
diff --git a/device/harness-device/firmware/main/ui/geist_sem_24.c b/devices/harness-device/firmware/main/ui/geist_sem_24.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/geist_sem_24.c
rename to devices/harness-device/firmware/main/ui/geist_sem_24.c
diff --git a/device/harness-device/firmware/main/ui/icons_engine.c b/devices/harness-device/firmware/main/ui/icons_engine.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/icons_engine.c
rename to devices/harness-device/firmware/main/ui/icons_engine.c
diff --git a/device/harness-device/firmware/main/ui/icons_engine.h b/devices/harness-device/firmware/main/ui/icons_engine.h
similarity index 100%
rename from device/harness-device/firmware/main/ui/icons_engine.h
rename to devices/harness-device/firmware/main/ui/icons_engine.h
diff --git a/device/harness-device/firmware/main/ui/icons_settings.c b/devices/harness-device/firmware/main/ui/icons_settings.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/icons_settings.c
rename to devices/harness-device/firmware/main/ui/icons_settings.c
diff --git a/device/harness-device/firmware/main/ui/icons_settings.h b/devices/harness-device/firmware/main/ui/icons_settings.h
similarity index 100%
rename from device/harness-device/firmware/main/ui/icons_settings.h
rename to devices/harness-device/firmware/main/ui/icons_settings.h
diff --git a/device/harness-device/firmware/main/ui/icons_voice.c b/devices/harness-device/firmware/main/ui/icons_voice.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/icons_voice.c
rename to devices/harness-device/firmware/main/ui/icons_voice.c
diff --git a/device/harness-device/firmware/main/ui/icons_voice.h b/devices/harness-device/firmware/main/ui/icons_voice.h
similarity index 100%
rename from device/harness-device/firmware/main/ui/icons_voice.h
rename to devices/harness-device/firmware/main/ui/icons_voice.h
diff --git a/device/harness-device/firmware/main/ui/spinner_spokes.c b/devices/harness-device/firmware/main/ui/spinner_spokes.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/spinner_spokes.c
rename to devices/harness-device/firmware/main/ui/spinner_spokes.c
diff --git a/device/harness-device/firmware/main/ui/spinner_spokes.h b/devices/harness-device/firmware/main/ui/spinner_spokes.h
similarity index 100%
rename from device/harness-device/firmware/main/ui/spinner_spokes.h
rename to devices/harness-device/firmware/main/ui/spinner_spokes.h
diff --git a/device/harness-device/firmware/main/ui/touch.c b/devices/harness-device/firmware/main/ui/touch.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/touch.c
rename to devices/harness-device/firmware/main/ui/touch.c
diff --git a/device/harness-device/firmware/main/ui/touch.h b/devices/harness-device/firmware/main/ui/touch.h
similarity index 100%
rename from device/harness-device/firmware/main/ui/touch.h
rename to devices/harness-device/firmware/main/ui/touch.h
diff --git a/device/harness-device/firmware/main/ui/ui_screens.c b/devices/harness-device/firmware/main/ui/ui_screens.c
similarity index 100%
rename from device/harness-device/firmware/main/ui/ui_screens.c
rename to devices/harness-device/firmware/main/ui/ui_screens.c
diff --git a/device/harness-device/firmware/main/ui/ui_screens.h b/devices/harness-device/firmware/main/ui/ui_screens.h
similarity index 100%
rename from device/harness-device/firmware/main/ui/ui_screens.h
rename to devices/harness-device/firmware/main/ui/ui_screens.h
diff --git a/device/harness-device/firmware/partitions.csv b/devices/harness-device/firmware/partitions.csv
similarity index 100%
rename from device/harness-device/firmware/partitions.csv
rename to devices/harness-device/firmware/partitions.csv
diff --git a/device/harness-device/firmware/screen.html b/devices/harness-device/firmware/screen.html
similarity index 99%
rename from device/harness-device/firmware/screen.html
rename to devices/harness-device/firmware/screen.html
index b2376f8c3..635f52870 100644
--- a/device/harness-device/firmware/screen.html
+++ b/devices/harness-device/firmware/screen.html
@@ -402,6 +402,6 @@
</section>
<footer>
- Commander device UI — device/harness-device/firmware/main/ui/ui_screens.c · round 466×466 CO5300 AMOLED · rendered from the live palette &amp; type scale.
+ Commander device UI — devices/harness-device/firmware/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-device/firmware/scripts/flash-station.sh b/devices/harness-device/firmware/scripts/flash-station.sh
similarity index 100%
rename from device/harness-device/firmware/scripts/flash-station.sh
rename to devices/harness-device/firmware/scripts/flash-station.sh
diff --git a/device/harness-device/firmware/scripts/gen_cable_vectors.py b/devices/harness-device/firmware/scripts/gen_cable_vectors.py
similarity index 96%
rename from device/harness-device/firmware/scripts/gen_cable_vectors.py
rename to devices/harness-device/firmware/scripts/gen_cable_vectors.py
index 4efc407b6..104d22eae 100644
--- a/device/harness-device/firmware/scripts/gen_cable_vectors.py
+++ b/devices/harness-device/firmware/scripts/gen_cable_vectors.py
@@ -1,8 +1,8 @@
#!/usr/bin/env python3
"""Generate the shared framing vectors for the USB cable link.
- device/harness-device/firmware/scripts/gen_cable_vectors.py # writes test/vectors/cable_frame.txt
- device/harness-device/firmware/scripts/gen_cable_vectors.py --check # fails if the file on disk differs
+ devices/harness-device/firmware/scripts/gen_cable_vectors.py # writes test/vectors/cable_frame.txt
+ devices/harness-device/firmware/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/harness-device/firmware/scripts/gen_cable_vectors.py — a third implementation, written",
+ "# Generated by devices/harness-device/firmware/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-device/firmware/scripts/gen_fonts.sh b/devices/harness-device/firmware/scripts/gen_fonts.sh
similarity index 100%
rename from device/harness-device/firmware/scripts/gen_fonts.sh
rename to devices/harness-device/firmware/scripts/gen_fonts.sh
diff --git a/device/harness-device/firmware/scripts/upload-firmware.sh b/devices/harness-device/firmware/scripts/upload-firmware.sh
similarity index 98%
rename from device/harness-device/firmware/scripts/upload-firmware.sh
rename to devices/harness-device/firmware/scripts/upload-firmware.sh
index 5997ea071..f5f77e720 100755
--- a/device/harness-device/firmware/scripts/upload-firmware.sh
+++ b/devices/harness-device/firmware/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/harness-device/firmware
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" # devices/harness-device/firmware
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/`
@@ -157,7 +157,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/harness-device/firmware/sdkconfig is left untouched.
+ # tracked defaults alone. The developer's interactive devices/harness-device/firmware/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-device/firmware/scripts/upload-flasher.sh b/devices/harness-device/firmware/scripts/upload-flasher.sh
similarity index 100%
rename from device/harness-device/firmware/scripts/upload-flasher.sh
rename to devices/harness-device/firmware/scripts/upload-flasher.sh
diff --git a/device/harness-device/firmware/sdkconfig.defaults b/devices/harness-device/firmware/sdkconfig.defaults
similarity index 100%
rename from device/harness-device/firmware/sdkconfig.defaults
rename to devices/harness-device/firmware/sdkconfig.defaults
diff --git a/device/harness-device/firmware/test/run.sh b/devices/harness-device/firmware/test/run.sh
similarity index 97%
rename from device/harness-device/firmware/test/run.sh
rename to devices/harness-device/firmware/test/run.sh
index c5025e327..ef44fa96b 100755
--- a/device/harness-device/firmware/test/run.sh
+++ b/devices/harness-device/firmware/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/harness-device/firmware/test/run.sh
+# devices/harness-device/firmware/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-device/firmware/test/test_board.c b/devices/harness-device/firmware/test/test_board.c
similarity index 100%
rename from device/harness-device/firmware/test/test_board.c
rename to devices/harness-device/firmware/test/test_board.c
diff --git a/device/harness-device/firmware/test/test_cable_frame.c b/devices/harness-device/firmware/test/test_cable_frame.c
similarity index 99%
rename from device/harness-device/firmware/test/test_cable_frame.c
rename to devices/harness-device/firmware/test/test_cable_frame.c
index ea2b0267f..5216b20fc 100644
--- a/device/harness-device/firmware/test/test_cable_frame.c
+++ b/devices/harness-device/firmware/test/test_cable_frame.c
@@ -1,6 +1,6 @@
// Runs the shared framing vectors against the firmware's own decoder, on a laptop.
//
-// device/harness-device/firmware/test/run.sh
+// devices/harness-device/firmware/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-device/firmware/test/test_cable_machines.c b/devices/harness-device/firmware/test/test_cable_machines.c
similarity index 99%
rename from device/harness-device/firmware/test/test_cable_machines.c
rename to devices/harness-device/firmware/test/test_cable_machines.c
index 33716ba23..8c95800d7 100644
--- a/device/harness-device/firmware/test/test_cable_machines.c
+++ b/devices/harness-device/firmware/test/test_cable_machines.c
@@ -1,6 +1,6 @@
// The machine-wheel ingest gate, on a laptop.
//
-// device/harness-device/firmware/test/run.sh
+// devices/harness-device/firmware/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-device/firmware/test/test_carousel_ring.c b/devices/harness-device/firmware/test/test_carousel_ring.c
similarity index 100%
rename from device/harness-device/firmware/test/test_carousel_ring.c
rename to devices/harness-device/firmware/test/test_carousel_ring.c
diff --git a/device/harness-device/firmware/test/vectors/cable_frame.txt b/devices/harness-device/firmware/test/vectors/cable_frame.txt
similarity index 99%
rename from device/harness-device/firmware/test/vectors/cable_frame.txt
rename to devices/harness-device/firmware/test/vectors/cable_frame.txt
index 3f71defe6..3887114d3 100644
--- a/device/harness-device/firmware/test/vectors/cable_frame.txt
+++ b/devices/harness-device/firmware/test/vectors/cable_frame.txt
@@ -1,5 +1,5 @@
# Shared framing vectors for the harness USB cable link.
-# Generated by device/harness-device/firmware/scripts/gen_cable_vectors.py — a third implementation, written
+# Generated by devices/harness-device/firmware/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-device/firmware/tools/generate_engine_icons.py b/devices/harness-device/firmware/tools/generate_engine_icons.py
similarity index 96%
rename from device/harness-device/firmware/tools/generate_engine_icons.py
rename to devices/harness-device/firmware/tools/generate_engine_icons.py
index 63f4f78c1..debe55e9c 100644
--- a/device/harness-device/firmware/tools/generate_engine_icons.py
+++ b/devices/harness-device/firmware/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/harness-device/firmware/tools/generate_engine_icons.py
+# python3 devices/harness-device/firmware/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/harness-device/firmware/main/ui/icons_engine.c"
+TARGET = REPO_ROOT / "devices/harness-device/firmware/main/ui/icons_engine.c"
ICON_SIZE = 20
EXPECTED_SHA256 = {
"codex.png": "8e82b26c98a10e45798ce48124515720657f7735fb8d0853b3f087eaa8a6b74e",
diff --git a/device/harness-device/firmware/version.txt b/devices/harness-device/firmware/version.txt
similarity index 100%
rename from device/harness-device/firmware/version.txt
rename to devices/harness-device/firmware/version.txt
diff --git a/docs/architecture.md b/docs/architecture.md
index 9a5887e1b..510a6fda9 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -78,5 +78,5 @@ and Boss mode routes it. A voice turn can carry a mode — `/goal` runs an instr
Firmware updates travel over the same cable in 16 KB credit windows, offered from the published
metadata and never for a dev build. `harness flash` re-flashes a device from a USB port. The firmware
-is ESP-IDF ≥ 5.5 under [`device/harness-device/firmware/`](device/harness-device/firmware/) (`idf.py set-target esp32s3 &&
+is ESP-IDF ≥ 5.5 under [`devices/harness-device/firmware/`](devices/harness-device/firmware/) (`idf.py set-target esp32s3 &&
idf.py build`); `make device-test` runs the host-side tests with no board attached.
diff --git a/docs/development.md b/docs/development.md
index c5c19da9d..637e991dd 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -7,7 +7,7 @@ desktop/ the app (Flutter; macOS first). third_party/xterm is the patched ter
cli/ the harness daemon and CLI (TypeScript, one bundle). src/engines/ is one folder per engine
backend/ the relay (Node, Prisma/MongoDB, Redis)
provider/ the API-provider spec, reference and example providers, conformance runner
-device/ firmware for the Harness device (ESP-IDF, device/harness-device/firmware)
+devices/ firmware for the Harness device (ESP-IDF, devices/harness-device/firmware)
store/ harnesses, shared viewers, the registry, Hello World, starter, schemas, and author tools
```