plugins/ruview/codex/README.md
This directory mirrors the Claude Code ruview plugin's operator commands as Codex prompts, plus an AGENTS.md carrying the RuView project rules.
| 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).
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.)
/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.CLAUDE.local.md (Git Bash / MSYS2 is not supported by ESP-IDF v5.4). Default ESP32 serial port: COM8.