>_ devnexus

// relay cli · v5.4.0

Your terminal,
finally wired together.

Relay is one static binary with zero runtime dependencies. Encrypted env sync, public tunnels, structured log tailing and one-shot preview deploys — all scriptable, all with a --json flag.

$ curl -fsSL https://get.devnexus.dev/relay | sh
Read Documentation → View Changelog
relay — a normal morning

$ relay env pull --branch feature/payments

✓ synced 14 variables from vault (encrypted at rest)

$ relay tunnel 3000 --qr

✓ https://f3a9.relay.devnexus.dev → localhost:3000

✓ QR rendered in terminal — scan to share with QA

$ relay deploy --preview

✓ preview live in 4.2s — https://pr-2841.devnexus.app

▌

// reference

Command reference

Every subcommand supports --json, --quiet and --help. Full man pages ship with the binary.

relay --help
  • relay init Bootstrap a workspace and link it to your DevNexus org.
  • relay env pull Sync encrypted environment variables from the vault, per branch.
  • relay env push Push local changes back to the vault with an audit trail.
  • relay tunnel <port> Expose a local port behind a public HTTPS URL. Add --qr to share.
  • relay logs --tail Tail structured logs with filters; --json for machine output.
  • relay deploy --preview One-shot preview deploy of the current branch.
  • relay trace <id> Fetch and render a NexusTrace flame graph in the terminal.
  • relay drift check Run DriftAPI contract checks against a base ref.
  • relay doctor Diagnose local setup: shell, PATH, certs, agent versions.

// scriptable

Built for your Makefile, not just your hands

JSON output mode means every command composes with jq, awk or your CI scripts. Exit codes are documented and stable across minor versions.

  • ✓ Single static binary — musl & glibc builds, no runtime deps
  • ✓ Shell completions for bash, zsh, fish & PowerShell
  • ✓ Stable, documented exit codes for CI gating
  • ✓ Works fully offline for local-first workflows
  • ✓ Config as code: .relay/config.yaml, committed to the repo
makefile — composable output

# fail the build on contract drift

check-drift:

  relay drift check --json \

    | jq 'select(.breaking == true)' \

    | grep -q '.' && exit 1 || true

 

# nightly preview of main

nightly-preview:

  relay deploy --preview --json > preview.json

  slack-notify "$$(jq -r .url preview.json)"

// install

Install it your way

Verified checksums and signatures on every channel. relay doctor validates the install afterwards.

curl

curl -fsSL https://get.devnexus.dev/relay | sh

homebrew

brew install devnexus/tap/relay

npm

npm i -g @devnexus/relay

nix

nix profile install devnexus#relay

Explore Tools → Start Building