CLI Reference
The rodiun CLI is installed with the Python SDK (pip install rodiun).
Commands
rodiun init
Interactive setup wizard. Prompts for API key and base URL, then writes a ~/.rodiun/config.yaml configuration file.
rodiun init
rodiun run
Execute an Orb by ID.
rodiun run <orb_id> [OPTIONS]
Options:
| Flag | Description |
|---|---|
--inputs TEXT | JSON string of Orb input parameters |
--endpoint TEXT | Override API base URL |
--dry-run | Validate inputs without executing |
Example:
rodiun run rodiun.notification-email@1.0.0 \
--inputs '{"to":"you@example.com","from_address":"app@co.io","subject":"Hello","body":"World"}'
Output:
{
"run_id": "run_abc123",
"status": "completed",
"receipt": {
"receipt_id": "rec_xyz789",
"trust_score": 95,
"risk_level": "low"
}
}
rodiun swap
Trigger a hot-swap for an Orb provider.
rodiun swap <orb_id> --provider <provider_name>
rodiun status
Show connection status and account info.
rodiun status
rodiun dev
Start a local Operon development server with mock providers.
rodiun dev [--port PORT] [--reset]
Options:
| Flag | Default | Description |
|---|---|---|
--port | 8080 | Port to bind the local server |
--reset | — | Clear local dev state before starting |
Configuration
Config file is stored at ~/.rodiun/config.yaml:
api_key: rdn_live_xxxxxxxxxxxx
base_url: https://api.rodiun.io
Environment variables override the config file:
| Variable | Description |
|---|---|
RODIUN_API_KEY | API key |
RODIUN_BASE_URL | API base URL |