rivA

AI agents are tools. And tools need visibility.

pip install riva

13 Agent Frameworks

Drop-in observability for the agents you already run.

Claude Code Codex CLI Gemini CLI OpenClaw LangGraph CrewAI AutoGen Cursor GitHub Copilot Windsurf Continue.dev Cline OpenCode

Features

Full-stack observability for AI agents.

📊

Real-Time Monitoring

Live TUI dashboard showing agent activity, CPU/memory usage, tool calls, and execution traces as they happen.

💰

Token Analytics

Track token usage per model, cost per agent run, daily breakdowns, and top tools by call count.

🔍

Security Audit

15+ automated checks — credential exposure, permission hardening, MCP supply chain risks, prompt injection detection, network anomalies.

Session Forensics

Turn-by-turn timelines, pattern detection (dead ends, retry loops, thrashing), decision-point extraction, and cross-session efficiency trends.

⌨️

CLI / TUI

Terminal-native interface. Scan, watch, audit, inspect forensics, query history — without leaving your terminal.

🌐

Web Dashboard

Flask-based browser UI with REST API. Overview, network, security, usage, config, and forensics tabs. Dark/light themes.

🖥️

System Tray

Native macOS menu bar app. Glanceable agent status, alerts, and quick actions. Compiled Swift binary.

📡

OpenTelemetry

Export metrics, logs, and traces to any OTel-compatible backend. Bundled Grafana dashboard. All three signal types supported.

Security First

Stability and security don't come from hoping agents behave. They come from watching them.
  • Tamper-evident HMAC-SHA256 audit log chain
  • Prompt injection detection and alerting
  • Boundary policy engine — file, network, and process limits
  • Credential exposure scanning (14 token patterns)
  • MCP supply chain checks (HTTP endpoints, shell commands)
  • CEF export for SIEM integration (Splunk, QRadar)

Getting Started

# Install Riva
$ pip install riva

# Scan for running agents
$ riva scan

# Live monitoring dashboard
$ riva watch

# Run a security audit
$ riva audit

# Session forensics
$ riva forensic summary latest

# Launch the web dashboard
$ riva web start

# Add your install to the community map
$ riva ping
Live

Where Agents runs, in the wild

A real-time map of local agent working worldwide. Add yours with riva ping.

Installs
Countries
Agent types
Open Live Map
Community Map installs · countries