Reflex Docs
CLI

reflex robots

Register robot schemas, register robots, and mint pairing tokens.

A robot schema describes the action/observation shape of a robot kind (e.g. SO-101, YAM bimanual). A robot is one specific physical unit bound to a schema and, optionally, a calibration.

reflex robots register-schema

Register a robot schema from a JSON file.

reflex robots register-schema so101_v1 --schema ./so101.schema.json
Argument / FlagDescription
SCHEMA_NAMERequired. Name for the schema.
--schemaRequired. Path to the schema JSON file.
--robot-kindOptional descriptor, e.g. so101.
--jsonJSON output.

reflex robots register

Register a robot instance.

reflex robots register lab-arm-01 --schema-id schema_abc123
Argument / FlagDescription
ROBOT_NAMERequired. Display name for the robot.
--schema-idRequired. Schema ID from register-schema.
--robot-kindOptional robot kind.
--calibration-idOptional calibration ID.
--jsonJSON output.

reflex robots pair

Mint a short-lived pairing token. Hand this token to the robot machine to claim the robot identity without copying API keys around.

reflex robots pair robot_xyz789 --ttl-seconds 600
FlagDefaultDescription
--ttl-seconds3600How long the pairing token is valid.
--jsonoffJSON output.

The token is single-use and expires when claimed or when the TTL runs out.