vrr/Ruview
2
0
Fork 0
mirror of https://github.com/ruvnet/RuView.git synced 2026-05-16 20:09:06 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6
Ruview/plugins/ruview/codex/README.md
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

2.9 KiB
Raw Permalink Blame History

RuView prompts for Codex (OpenAI CLI)

This directory mirrors the Claude Code ruview plugin's operator commands as Codex prompts, plus an AGENTS.md carrying the RuView project rules.

Contents

File Purpose
AGENTS.md Project rules — repo layout, hard rules, build/test, ESP32 firmware on Windows, witness verification
prompts/ruview-start.md Onboarding — Docker demo / repo build / live ESP32
prompts/ruview-flash.md Build + flash ESP32 firmware (8MB / 4MB)
prompts/ruview-provision.md Provision WiFi creds + sink IP + channel/MAC overrides
prompts/ruview-app.md Run a sensing application (presence / vitals / pose / sleep / MAT / point cloud)
prompts/ruview-train.md Train / evaluate / publish a model (incl. GPU on GCloud)
prompts/ruview-advanced.md Multistatic / tomography / cross-viewpoint / field-model / mesh-security
prompts/ruview-verify.md Run the trust pipeline + pre-merge checklist

Prompt parity with the Claude Code plugin is enforced by plugins/ruview/scripts/smoke.sh (every commands/<name>.md must have a matching codex/prompts/<name>.md).

Install

Per-user prompts — copy the prompt files into Codex's prompt directory:

mkdir -p ~/.codex/prompts
cp plugins/ruview/codex/prompts/*.md ~/.codex/prompts/
# now in the codex TUI:  /ruview-start   /ruview-flash   /ruview-app   /ruview-train   /ruview-verify   /ruview-advanced

Project rules — point Codex at the AGENTS.md. Codex auto-discovers an AGENTS.md at the repo root and in the working directory; either symlink it or copy it:

ln -s plugins/ruview/codex/AGENTS.md AGENTS.md          # repo root (if you don't already have one)
# — or, if a root AGENTS.md exists, append the relevant sections from plugins/ruview/codex/AGENTS.md

Config (optional) — to keep prompts in-repo instead of ~/.codex/prompts, add to ~/.codex/config.toml:

# Codex reads prompts from ~/.codex/prompts by default; symlinking keeps them versioned with the repo:
#   ln -s "$PWD/plugins/ruview/codex/prompts" ~/.codex/prompts/ruview   (then prompts appear as /ruview/ruview-start, etc.)

Notes

  • The Codex mirror is the operator-facing subset — the seven /ruview-* commands. The Claude Code plugin additionally ships skills (ruview-quickstart, ruview-hardware-setup, ruview-configure, ruview-applications, ruview-model-training, ruview-advanced-sensing, ruview-cli-api, ruview-mmwave, ruview-verify) and agents (ruview-onboarding-guide, ruview-config-engineer, ruview-training-engineer) that have no Codex equivalent — their content is folded into AGENTS.md and the prompt files.
  • On Windows, ESP-IDF firmware builds go through the Python-subprocess pattern documented in CLAUDE.local.md (Git Bash / MSYS2 is not supported by ESP-IDF v5.4). Default ESP32 serial port: COM8.