# RuView Agent Prototype

Prototypes agents that read RuView sensing events live and store state with sensor data.

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

## Install

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

## Description

Explore and prototype rvAgent + RVF integration for RuView agentic flows. Use when working on cross-cog coordination, operator-facing agents reading BFLD / pose / vitals events live, or persisting agent state alongside sensing data in the same RVF container.

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

# RuView rvAgent + RVF integration

Surface area for wiring `vendor/ruvector/crates/rvAgent/` into RuView so the existing sensing pipeline becomes the substrate an agentic flow can read, reason about, and respond to.

## Quickstart, published MCP server (`@ruvnet/rvagent` v0.1.0)

Installing this plugin registers `@ruvnet/rvagent` as an MCP server. On activation, Claude Code spawns `npx -y @ruvnet/rvagent` and exposes its tools directly:

| Tool | Purpose |
|------|---------|
| `bfld_last_scan` | Most recent BFLD event from the sensing server |
| `bfld_subscribe` | Stream BFLD events for a window |
| `presence_now` | Current room-level presence state |
| `vitals_get_breathing` | Latest breathing-rate sample |
| `vitals_get_heart_rate` | Latest heart-rate sample |
| `vitals_get_all` | Composite vitals snapshot |
| `vitals_fetch` | Historical vitals window |

Override the sensing-server URL via the `RVAGENT_SENSING_URL` env var (default `http://localhost:3000`). Source lives at `tools/ruview-mcp/`; ADR-124 captures the design.

Smoke-check the wiring: `npm view @ruvnet/rvagent version` should return `0.1.0` (or newer).

## When to use this skill

- "I want an agent that reacts to BFLD presence in the kitchen and pages the carer."
- "I need cog-pose-estimation and cog-bfld to negotiate before publishing a synthesized event."
- "Can the witness chain attest both the sensing event AND the agent decision in one RVF blob?"
- "How do we keep rvAgent's tool outputs class-3 compliant when the source BFLD event is Restricted?"

## Key surfaces

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