mirror of https://github.com/ruvnet/RuView synced 2026-06-09 10:13:17 +00:00

Files

T

ruv 8ff7c2c35a feat(plugins): RuView Claude Code + Codex marketplace plugin

Add `plugins/ruview` — an end-to-end toolkit for working with RuView
(WiFi-DensePose) from Claude Code, mirrored as Codex prompts.

Marketplace: `plugins/.claude-plugin/marketplace.json` (one plugin, `ruview`).

Skills (9): ruview-quickstart, ruview-hardware-setup, ruview-configure,
ruview-applications, ruview-model-training, ruview-advanced-sensing,
ruview-cli-api, ruview-mmwave, ruview-verify — shell-first (cargo / python /
idf.py / docker / node), no claude-flow MCP dependency.

Commands (7): /ruview-start, /ruview-flash, /ruview-provision, /ruview-app,
/ruview-train, /ruview-advanced, /ruview-verify.

Agents (3): ruview-onboarding-guide, ruview-config-engineer,
ruview-training-engineer.

Codex mirror: codex/AGENTS.md + codex/README.md + codex/prompts/*.md (full
command parity, enforced by scripts/smoke.sh).

Docs: docs/adrs/0001-ruview-plugin-contract.md (Proposed). Verification:
scripts/smoke.sh (13 structural checks). Provisioning docs reflect the full
`provision.py` flag set (TDM mesh, edge tiers, vitals, hop channels, Cognitum
Seed, swarm intervals) and the issue #391 NVS-namespace-replace gotcha.

Verified: `claude plugin validate` (plugin + marketplace), loads via
`claude --plugin-dir`, smoke 13/13, and confirmed against an attached ESP32-S3
on COM8 running the RuView CSI firmware (live adaptive_ctrl + csi_collector
serial output).

Co-Authored-By: claude-flow <ruv@ruv.net>

2026-05-11 17:39:16 -04:00

1.7 KiB

Raw Permalink Blame History

/ruview-flash — build + flash ESP32 firmware

Build and flash RuView ESP32 firmware. Variant + port: $ARGUMENTS (default 8mb, port COM8).

Variant. 8mb → ensure it builds from firmware/esp32-csi-node/sdkconfig.defaults.template (no mock — real WiFi CSI). 4mb → cp firmware/esp32-csi-node/sdkconfig.defaults.4mb firmware/esp32-csi-node/sdkconfig.defaults first (display disabled, dual OTA via partitions_4mb.csv). heltec → sdkconfig.defaults.heltec_n16r2.
Build (Windows). ESP-IDF v5.4 does NOT work under Git Bash; cmd.exe /C hangs. Use the Espressif Python venv as a subprocess with MSYSTEM* env vars stripped — the exact command is in CLAUDE.local.md ([python, idf_py, 'build'], cwd = firmware/esp32-csi-node). Outputs in firmware/esp32-csi-node/build/{bootloader/bootloader.bin, partition_table/partition-table.bin, esp32-csi-node.bin, ota_data_initial.bin}.

Flash. Same subprocess with [python, idf_py, '-p', 'COM8', 'flash'], or:

python -m esptool --chip esp32s3 --port COM8 --baud 460800 write_flash \
  0x0 firmware/esp32-csi-node/build/bootloader/bootloader.bin \
  0x8000 firmware/esp32-csi-node/build/partition_table/partition-table.bin \
  0xf000 firmware/esp32-csi-node/build/ota_data_initial.bin \
  0x20000 firmware/esp32-csi-node/build/esp32-csi-node.bin

Confirm. Serial monitor via pyserial on COM8 @ 115200 (NOT idf.py monitor — it hangs in a subprocess). Then cd v2 && cargo run -p wifi-densepose-sensing-server — frames should arrive. If not: re-run /ruview-provision, match the AP channel, drop any --filter-mac.

Never test in mock mode — the Kconfig fall-threshold bug only showed up with real CSI.

1.7 KiB Raw Permalink Blame History

/ruview-flash — build + flash ESP32 firmware

1.7 KiB

Raw Permalink Blame History