# RuView CLI and API

Uses the wifi-densepose CLI, REST API and browser build to integrate RuView.

- Repository: https://github.com/ruvnet/RuView (101983 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ruvnet/RuView --skill ruview-cli-api -g -a claude-code -y`
Codex: `npx skills add ruvnet/RuView --skill ruview-cli-api -g -a codex -y`
Cursor: `npx skills add ruvnet/RuView --skill ruview-cli-api -g -a cursor -y`
Gemini CLI: `npx skills add ruvnet/RuView --skill ruview-cli-api -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ruvnet/RuView`

## Description

Use the RuView `wifi-densepose` CLI binary (incl. MAT scan/status/zones/survivors/alerts/export subcommands), the REST API (`wifi-densepose-api`, Axum), and the browser/WASM build (`wifi-densepose-wasm`, `wifi-densepose-wasm-edge`). Use when integrating RuView into another program, scripting it from the shell, exposing it over HTTP, or shipping it to the browser / ESP32-WASM3.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# RuView CLI, API & WASM

The programmatic surfaces of RuView, the `wifi-densepose` binary, the HTTP API, and the WebAssembly builds.

## 1. The `wifi-densepose` CLI binary (`wifi-densepose-cli`)

```bash
cd v2
cargo run -p wifi-densepose-cli -- --help        # or: cargo build -p wifi-densepose-cli --release  → target/release/wifi-densepose
cargo run -p wifi-densepose-cli -- version
```

Top-level subcommands: `version`, and `mat` (Mass Casualty Assessment Tool).

### `wifi-densepose mat …`, disaster survivor detection

| Subcommand | Purpose | Key flags |
|------------|---------|-----------|
| `mat scan [zone]` | Start scanning for survivors | `--disaster-type <…>`, `--sensitivity 0.0, 1.0`, `--max-depth <m>`, `--continuous`, `--interval <ms>`, `--simulate` |
| `mat status` | Current scan status | `--detailed`, `--format <…>`, `--watch` |
| `mat zones …` | Manage scan zones | `zones list [--active-only]`, plus add/remove/update |
| `mat survivors` | List detected survivors with triage status | |
| `mat alerts` | View / manage alerts | |
| `mat export` | Export scan data | JSON or CSV |

Example:
```bash
cargo run -p wifi-densepose-cli -- mat scan rubble-A --disaster-type earthquake --sensitivity 0.7 --max-depth 5 --continuous --interval 2000
cargo run -p wifi-densepose-cli -- mat survivors --format json
cargo run -p wifi-densepose-cli -- mat export --format csv > survivors.csv
```

Use `--simulate` for testing without hardware. Background and user guide: `docs/wifi-mat-user-guide.md`, `wifi-densepose-mat` crate.

## 2. REST API (`wifi-densepose-api`, Axum)

Library crate (`v2/crates/wifi-densepose-api/src/lib.rs`), the Axum router/handlers; configured via the `wifi-densepose-config` crate. It's wired into the server binaries (e.g. the sensing server / Docker image), not a standalone `cargo run` target by itself.

The rest: https://github.com/ruvnet/RuView/blob/HEAD/plugins/ruview/skills/ruview-cli-api/SKILL.md