Beyond Cortex
Cortex References

Cortex References

Global Options

These flags work across most commands and can be placed before or after subcommands.

Prop

Type

voltra --help
voltra -v
voltra --json status
voltra --local-time --json workout list --start 2026-06-01 --end 2026-06-23
voltra --command-timeout-ms 60000 connect <DEVICE_ID>

Quick Start

voltra doctor                              # 1. Diagnose environment
voltra config set-api-key <API_KEY>        # 2. Configure API key (required for device/training commands)
voltra whoami                             #    Verify identity
voltra scan                               # 3. Scan for devices
voltra connect <DEVICE_ID>                # 4. Connect (starts background session)
voltra status                             # 5. Check device status
voltra set-mode weight-training           # 6. Set mode + parameters
voltra set-weight 20 --unit lbs
voltra config accept-physical-risk        #    Accept physical risk (required once before load)
voltra load                               # 7. Load resistance
voltra unload                             # 8. Unload
voltra finish-training                    #    End training session
voltra disconnect                         #    Disconnect

API key required: All device/training commands that go through the background session (scan, connect, set-mode, load, etc.) require a persisted API key (voltra config set-api-key). Without a key, these commands exit with an error. Cloud commands (workout, actions, session, custom-curve, etc.) also support the --api-key flag for temporary override.