Cloud commands

The cloud subcommands handle authentication, sandbox provider setup, remote workflow execution, and syncing code changes back to your machine.

Log in and inspect account state

agent-relay cloud login
agent-relay cloud whoami
agent-relay cloud logout

• login opens the browser-based cloud auth flow.
• whoami prints the current user, organization, workspace, and scopes.
• logout clears stored cloud credentials.

Connect a provider

agent-relay cloud connect claude --language typescript

This command opens an interactive SSH-backed auth session for a provider sandbox. It requires a real TTY. The CLI also accepts provider aliases:

• claude maps to anthropic
• codex maps to openai
• gemini maps to google

Run a workflow remotely

agent-relay cloud run relay.yaml --sync-code

Useful follow-up commands:

agent-relay cloud status <run-id>
agent-relay cloud logs <run-id> --follow
agent-relay cloud sync <run-id>

• status fetches the latest state for a run.
• logs streams workflow or per-agent output.
• sync downloads the generated patch and applies it locally.

Inspect a patch before applying it

agent-relay cloud sync <run-id> --dry-run

Use --dir <path> if the patch should apply somewhere other than the current directory.

Deprecated alias

The top-level agent-relay connect <provider> command is deprecated. Use agent-relay cloud connect <provider> instead.

See also