ROVA

░▒▓███████▓▒░        ░▒▓██████▓▒░       ░▒▓█▓▒░░▒▓█▓▒░       ░▒▓██████▓▒░
░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░
░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░       ░▒▓█▓▒▒▓█▓▒░       ░▒▓█▓▒░░▒▓█▓▒░
░▒▓███████▓▒░       ░▒▓█▓▒░░▒▓█▓▒░       ░▒▓█▓▒▒▓█▓▒░       ░▒▓████████▓▒░
░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░        ░▒▓█▓▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░
░▒▓█▓▒░░▒▓█▓▒░      ░▒▓█▓▒░░▒▓█▓▒░        ░▒▓█▓▓█▓▒░        ░▒▓█▓▒░░▒▓█▓▒░
░▒▓█▓▒░░▒▓█▓▒░       ░▒▓██████▓▒░          ░▒▓██▓▒░         ░▒▓█▓▒░░▒▓█▓▒░

Runtime Orchestration for Verifiable Agents

한국어 README

ROVA is a CLI-first runtime for giving one human owner a traceable AI execution team. It turns a mission into reviewable artifacts, runtime records, verification results, reports, memory proposals, repository context, and operator views without hiding execution behind a single chat transcript.

The long-term product direction is an AI team runtime that can plan, inspect, verify, and eventually execute governed work across models, tools, skills, and repositories. The current release focuses on a local, inspectable, deterministic control plane.

Install

ROVA is published on npm as rova-ai. The installed command is rova.

npm install -g rova-ai
rova --version
rova --help

One-off usage:

npx rova-ai --help
pnpm dlx rova-ai --help

Source installer:

curl -fsSL https://raw.githubusercontent.com/raeseoklee/rova/main/scripts/install.sh | bash
rova --version

For a reproducible source install, set ROVA_REF to a tag or commit.

curl -fsSL https://raw.githubusercontent.com/raeseoklee/rova/main/scripts/install.sh | ROVA_REF=v0.1.0 bash

Quick Start

mkdir rova-demo
cd rova-demo
rova init --no-setup

mission_id=$(rova mission create \
  --title "Plan a billing dashboard" \
  --goal "Draft a PRD, technical spec, task graph, verification record, and report for a SaaS billing dashboard.")

rova mission run "$mission_id"
rova mission show "$mission_id"
rova artifact list "$mission_id"
rova report generate "$mission_id"
rova ops overview

This creates a local .rova/ workspace, generates deterministic mission artifacts, records trace events, verifies the artifacts, and exposes the run through inspection commands.

Screenshot

Demo Flow

The quick-start sequence above is the current public demo path:

1. Initialize a governed local workspace.
2. Create a mission from a product or engineering goal.
3. Generate PRD, technical spec, and task graph artifacts.
4. Inspect mission details, traces, reports, and operations status.
5. Switch providers only when you explicitly opt into network or local host execution.

Provider Modes

ROVA keeps the safe offline path available while allowing explicit real-model execution.

| Setup choice | Internal provider | Use case | | --- | --- | --- | | local-demo | mock | Deterministic offline artifacts for first runs, tests, demos, and CI. | | openai-compatible | openai-compatible | API-backed model execution through environment credentials. | | subscription-cli | subscription-cli | Subscribed LLM services accessible through an authenticated local CLI command. |

Interactive setup shows local-demo instead of asking new users to choose a raw mock provider:

rova init
# or rerun later
rova setup

OpenAI-compatible execution is configured interactively through rova setup, which collects the base URL, model, and API key and stores the key in .rova/secrets.json. Manual configuration is also supported:

rova config set provider openai-compatible
rova config set network allow-provider
export ROVA_OPENAI_BASE_URL="https://api.openai.com/v1"
export ROVA_OPENAI_API_KEY="..."
export ROVA_OPENAI_MODEL="..."
rova doctor
rova provider smoke --json

Local subscription-host execution uses an already-authenticated command. ROVA does not store subscription tokens, browser cookies, or API keys in .rova/config.json. Run rova setup, choose subscription-cli, and enter the command name — ROVA will run a smoke check and offer to log in if needed.

rova config set provider subscription-cli
rova config set network allow-provider
export ROVA_SUBSCRIPTION_CLI_COMMAND="my-authenticated-ai-wrapper"
export ROVA_SUBSCRIPTION_CLI_ARGS_JSON='["--json"]'
rova provider discover --json
rova provider smoke --json

The subscription-cli adapter does not forward the full parent environment. If a wrapper needs extra environment variables, pass only reviewed names through ROVA_SUBSCRIPTION_CLI_ENV_PASSTHROUGH_JSON.

What Works Today

• Local .rova/ workspaces, setup, doctor checks, config inspection, and JSON output.
• Mission creation and execution with PRD, technical spec, task graph, verification, trace, and report artifacts.
• Mission explanation, workflow reconstruction, evaluation, comparison, forensics, and improvement proposals over owned records.
• Owner-managed bounded memory records with explicit proposal and acceptance flows.
• Read-only local skill discovery, diagnostics, template previews, usage summaries, lifecycle records, and version snapshots.
• Repository scan, source map, ownership hints, mission context, patch-request, diff-preview, and owner-approved patch apply/rollback flows.
• Read-only operations views for attention, approvals, failures, health, policy, timelines, runbooks, mission boards, evaluations, improvements, and bundles.

ROVA does not yet execute MCP servers, plugins, or user-defined skills.

Documentation

• Documentation map
• Implementation plan
• Roadmap
• Distribution strategy
• Release policy
• Progress snapshot

Local Development

pnpm install
pnpm build
pnpm test
pnpm typecheck
pnpm test:install
pnpm test:source-install
pnpm test:packlist
pnpm test:package
pnpm release:readiness

CI verifies build, tests, installer checks, package-contract checks, package smoke tests, release-readiness checks, and source-name guards. CI does not publish packages.

License

Apache-2.0.

Tagline

Run AI teams you can trace, verify, and trust.