Documentation

Build with Renovix.

Concepts, integration guides, REST and MCP APIs, deployment options, and operational runbooks.

Get started

Start in fifteen minutes.

01

Connect a repo

Point Renovix at a Git mirror of your legacy codebase. SSH, Git over HTTPS, or upload archive.

02

Run discovery

The discovery agent inventories programs, copybooks, and runtime dependencies in 5–30 minutes.

03

Translate a module

Pick a leaf module. Renovix produces target-stack code, tests, and a citation trail.

CLI

One command to start a migration.

The Renovix CLI works against the same APIs as the web UI. It is built for CI pipelines and platform teams who want to script the migration lifecycle.

# install
$ npm install -g @renovix/cli

# authenticate
$ renovix login

# start a migration
$ renovix migrate \
    --engine cobol \
    --source ./mainframe-mirror \
    --target kotlin-spring \
    --policy ./renovix.policy.yaml

# watch progress
$ renovix status --watch
REST API

Programmatic control.

Every action available in the Renovix UI is also available over a REST or MCP API. SDKs are available for TypeScript and Python, with parity guarantees.

  • →
    WorkspacesCreate and manage migration projects.
  • →
    ModulesTranslate, verify, and approve modules.
  • →
    Verifier runsTrigger and inspect shadow-execution runs.
  • →
    AuditStream the audit log to your SIEM.
// POST /v1/workspaces/:id/translate
{
  "module": "CLAIMS01.cbl",
  "target": "kotlin-spring",
  "style_guide": "meridian-internal",
  "reviewers": ["sme@meridian.com"]
}

// Response
{
  "run_id": "trn_8z2c...",
  "status": "queued",
  "estimated_complete":
    "2026-05-26T18:42:00Z"
}
Concepts

Mental model.

Workspace

A migration project. Holds the source mirror, runtime traces, configurations, and reviewers.

Module

The unit of translation. Maps roughly to one COBOL program, one EJB, or one WebForms page.

Engine

The translation pipeline for a specific legacy stack — COBOL, Java EE, .NET, Oracle Forms, RPG.

Verifier

The shadow-execution diff engine. Decides whether a translated module is safe to ship.

Policy

Configuration: target stack, style guide, reviewer rules, escalation paths, abstention thresholds.

Audit log

Immutable event stream of every agent and human action in the workspace.

Integrations

Plugs into your stack.

Source control

GitHub, GitLab, Bitbucket, Azure DevOps, Endevor, ChangeMan.

CI / CD

GitHub Actions, GitLab CI, Jenkins, CircleCI, Buildkite.

Identity

Okta, Entra ID, Ping Identity, Auth0, OneLogin.

Comms

Slack, Microsoft Teams, email, PagerDuty, Opsgenie.

Tickets

Jira, ServiceNow, Linear, Asana.

SIEM

Splunk, Sumo Logic, Datadog, Elastic, Chronicle.

Cloud

AWS, Azure, GCP, Oracle Cloud, OpenShift.

MCP

Renovix exposes an MCP server for tool-use by external agent runtimes.

SDKs

Official SDKs.

// TypeScript
import { Renovix } from "@renovix/sdk";

const rx = new Renovix({
  apiKey: process.env.RENOVIX_API_KEY!,
});

const run = await rx.translate({
  workspace: "ws_meridian_core",
  module: "CLAIMS01.cbl",
  target: "kotlin-spring",
});
# Python
from renovix import Renovix

rx = Renovix(api_key=os.environ["RENOVIX_API_KEY"])

run = rx.translate(
    workspace="ws_meridian_core",
    module="CLAIMS01.cbl",
    target="kotlin-spring",
)

for ev in rx.stream(run.id):
    print(ev)
Operations

Run a migration in production.

Rate limits

Per-workspace token-bucket. Enterprise contracts include dedicated capacity.

SLAs

99.95% uptime on platform; 99.5% on inference. Penalties apply on enterprise contracts.

Latency

P99 under 2s for synchronous endpoints; translation runs are async by design.

Webhooks

Signed webhooks on every workspace event with retry, dedupe, and replay.

Observability

OpenTelemetry traces, structured logs, and metrics endpoints for Prometheus.

Runbooks

Operational runbooks for cutover, rollback, and incident response.

FAQ

Common questions.

Yes. The CLI and APIs are designed for CI integration. Run translation as part of your PR pipeline; gate merges on verifier pass.
The TypeScript and Python SDKs are Apache 2.0 licensed and published on GitHub. The engine itself is closed source.
API keys are scoped per workspace and provisioned in the admin console. Service-account keys with rotation are recommended for production use.
Renovix exposes an MCP server so external agent runtimes (Claude, OpenAI Agents, LangGraph, custom) can use Renovix tools natively.

Need help integrating?

Our customer engineering team will pair with your platform engineers on the first run.

Talk to customer engineering