Exec

Resumable exec

Run a remote command once, then detach, inspect, or stop it later.

Overview Install Shell Exec MCP

Core commands

Use the job id from a detached run with onyx attach, onyx logs, or onyx kill.

Run
onyx exec prod -- ./deploy.sh
Detach
onyx exec gpu-box --detach -- python train.py
Logs
onyx logs gpu-box job_xxx
Kill
onyx kill gpu-box job_xxx

Common flags

Use these when the job needs a working directory, extra environment, or a hard timeout.

cwd
onyx exec prod --cwd /srv/app -- ./deploy.sh
env
onyx exec prod --env RUST_LOG=info -- cargo test
timeout
onyx exec prod --timeout 60s -- cargo test