2.5 KiB
npx @ruvnet/ruview — RuView WiFi-sensing operator harness
An AI agent harness that knows how to operate RuView (WiFi-DensePose): onboard a
newcomer, provision an ESP32 CSI node, calibrate a room, train pose models, and —
crucially — refuse to overstate accuracy. Minted from the RuView monorepo via
metaharness and hardened per ADR-182.
WiFi sensing infers coarse pose/presence/breathing from Channel State Information.
It is not a camera. Every accuracy number this harness emits must be MEASURED
against a baseline — that rule is enforced in code (ruview.claim_check).
Quick start
npx @ruvnet/ruview # onboard — pick a setup path
npx @ruvnet/ruview claim-check --text "we hit 100% accuracy" # the honesty guardrail
npx @ruvnet/ruview verify # run the deterministic proof (VERDICT: PASS)
npx @ruvnet/ruview doctor # self-check (tools + optional kernel/host)
npx @ruvnet/ruview --help
The operator tools are pure Node and run with zero install weight. The
@metaharness/kernel + host adapter are optionalDependencies — only doctor /
install use them, only if present.
Tools (ruview.*)
Exposed both as CLI verbs and as an MCP server (npx @ruvnet/ruview mcp start):
| Tool | What it does |
|---|---|
ruview.onboard |
Pick docker-demo / repo-build / live-esp32; print the next command |
ruview.claim_check |
Lint text for untagged / overstated accuracy claims (guardrail) |
ruview.verify |
Run verify.py deterministic proof → VERDICT |
ruview.node_monitor |
Assert CSI is flowing on an ESP32 (read-only) |
ruview.calibrate |
ADR-151 room pipeline (baseline→enroll→train-room→room-watch) |
ruview.node_flash |
Build+flash firmware (Windows/ESP-IDF; mutating, guarded) |
Every tool is fail-closed: missing repo / python / binary / port → an honest negative, never a fabricated success.
Skills
Host-neutral playbooks in skills/ (onboard, provision-node, calibrate-room,
train-pose, verify). npx @ruvnet/ruview skill <name> prints one.
Use as a Claude Code MCP server
The bundled .claude/settings.json registers the ruview MCP server
(npx -y @ruvnet/ruview mcp start). Drop this package's .claude/ into a repo, or run
npx @ruvnet/ruview install --host claude-code.
Hosts
claude-code (bundled), and via metaharness host adapters: codex, opencode, copilot, pi-dev, hermes, rvm, github-actions.
License
MIT © ruvnet