Device Discovery & Connection

Discovery & Connection

Command	Options	Notes
`voltra scan`	`[--timeout-ms <ms>] [--timeout <ms>] [--all] [--json]`	Scan for VOLTRA devices. Default: known/matching only; `--all` shows everything. Requires persisted API key.
`voltra connect <device>`	`[--replace-known <id>] [--timeout-ms <ms>] [--timeout <ms>] [--json]`	Connect, perform handshake, save as known device, and start a background session. Current builds support up to two independent device sessions. `<device>` accepts: ID/MAC, exact name, or 1-based scan result index.
`voltra reconnect`	`[--device-id <id>] [--timeout-ms <ms>] [--timeout <ms>] [--json]`	Reconnect the last successfully connected device, or select one explicitly.
`voltra disconnect`	`[--device-id <id>] [--timeout-ms <ms>] [--timeout <ms>] [--json]`	Disconnect the selected device session; without a selector, use the active session.
`voltra list-known` / `voltra devices`	`[--json]`	List locally saved known devices. `devices` is an alias.

voltra scan --timeout-ms 10000
voltra scan --all
voltra connect <DEVICE_ID>
voltra connect 1                   # 1st result from most recent scan
voltra connect <NEW_ID> --replace-known <OLD_ID>
voltra reconnect
voltra disconnect
voltra --json devices

Two independent connections are separate physical sessions. They do not create a Twin or synchronize training automatically. Connect both devices, then use --device-id for status and control commands:

voltra connect <DEVICE_A>
voltra connect <DEVICE_B>
voltra status --device-id <DEVICE_A> --json
voltra status --device-id <DEVICE_B> --json

After a Twin is confirmed, voltra status --json reports the logical Twin owner. If the daemon's active session is the Twin slave, status automatically uses the connected master. Do not select the slave while the Twin is active: the slave no longer has an independent live session. Use voltra twin status --master <MASTER> --json for topology details. After unpairing, the devices are independent again and can be selected separately.

To pair the two sessions into a Twin, follow Twin & Dual-Device Connections.

Device Status

Command	Options	Notes
`voltra status`	`[--device-id <id>] [--device <id>] [--timeout-ms <ms>] [--json]`	Live device snapshot. Defaults to the active device; for a confirmed Twin, an unselected status resolves an active slave session to the connected master. Use the master selector when disambiguation is needed; the slave is not an independent live target until unpaired.
`voltra refresh [scope]`	`[--device-id <id>] [--device <id>] [--json]`	Refresh device parameters. `scope`: `all`, `epStatus`, `trainingMode`, `weightTraining`, `resistanceBand`, `damper`, `isokinetic`, `autoUnload`, `cableLength`, `workoutState`. Default: `all`.

voltra status --json
voltra status --device-id <DEVICE_ID>
voltra refresh all --json

Background Session

Command	Options	Notes
`voltra daemon status`	`[--json]`	Report daemon running status, PID, and all connected session information.
`voltra daemon stop`	`[--json]`	Stop the background daemon. Use before reinstalling or when a clean restart is needed.

voltra daemon status --json
voltra daemon stop

Logs

Command	Options	Notes
`voltra logs path`	`[--json]`	Print local log file paths (cli / daemon / ble).
`voltra logs tail`	`[-n <lines>] [--file cli\|daemon\|ble\|all] [--json]`	Print recent log lines. Default: 100 lines, all files.
`voltra logs clear`	`[--json]`	Remove all local log files. Irreversible.

voltra logs path --json
voltra logs tail --file cli -n 200
voltra logs clear

Diagnostics

Command	Options	Notes
`voltra doctor`	`[--json]`	General Cortex/system diagnostics.
`voltra diagnostics api`	`[--api-key <key>] [--timeout-ms <ms>] [--proxy-mode normal/direct] [--save <path>] [--json]`	Read-only API transport diagnostics with an automatic diagnosis: target, credential visibility, process context, proxy-variable presence, DNS, direct TCP, and the authenticated user-info request. Values are redacted. `--proxy-mode` accepts `normal` or `direct`; `direct` disables HTTP proxy discovery for this request only. `--save` writes the same redacted JSON report to a file.
`voltra ble doctor`	`[--json]`	BLE-focused diagnostics. Use when scan/connect fails. Currently equivalent to `voltra doctor`.

voltra doctor --json
voltra ble doctor

Device Discovery & Connection