The reference CLI for working with OpenRGD profiles.

rgd is the Python toolchain shipped by the canonical OpenRGD repository. It manages profile materialization, integrity verification, evidence import, deterministic compilation and static interoperability generation.

Developer guides CLI reference ↗

RGD REPRESENTATION

Defined by OpenRGD.

Robot Graph Definition is the semantic profile/graph representation defined by the standard. Read the conceptual and standard-level definition on /openrgd.

rgd TOOLCHAIN

Implemented as reference Python tooling.

The lowercase rgd command works with OpenRGD source trees and derived artifacts. Toolchain versioning is independent from the standard bundle and candidate contracts.

COMMAND SURFACE

One toolchain, explicit guarantees for each operation.

initrgd init Robot

Materialize a project from the packaged default profile and recalculate its source-tree commitment.

importrgd import robot.urdf --out partial-robot

Extract source-supported Foundation evidence from URDF or the supported USDA subset.

hashrgd hash

Verify OPENRGD_SOURCE_TREE_SHA256_V1 or intentionally update it with --write.

checkrgd check --output json

Validate canonical structure, source integrity and selected JSONC modules.

bootrgd boot --output json

Build OPENRGD_NON_ACTUATING_GROUNDING_CONTEXT.

compilergd compile-spec

Generate one deterministic machine bundle from the verified source tree.

exportrgd export ros2 --out export/ros2

Generate deterministic, static ROS 2 interoperability artifacts.

VERIFIED LIFECYCLE

The current CI exercises a non-actuating end-to-end path.

01ImportURDF / USDA

02Enrichexplicit seed

03Hashsource integrity

04Checkprofile validation

05Bootgrounding context

06Compilemachine bundle

07Exportstatic ROS 2

TOOLCHAIN BOUNDARY

The CLI is deliberately non-actuating.

rgd check does not assess hardware readiness or operational safety.rgd boot explicitly records physical execution as not assessed and not authorized. Static ROS 2 export does not launch middleware or issue actuator commands.

IMPLEMENTED GUIDES

The reference CLI for working with OpenRGD profiles.

Defined by OpenRGD.

Implemented as reference Python tooling.

One toolchain, explicit guarantees for each operation.

The current CI exercises a non-actuating end-to-end path.

The CLI is deliberately non-actuating.

Use the tooling against real source evidence.

Import URDF

Import USD / USDA

Validation

Export ROS 2