Skip to main content

Usage

cassian ssh [command] [options]
With no arguments: opens an interactive terminal with bidirectional file sync. With a command: runs it non-interactively and returns (same as cassian exec).

Options

FlagDescription
--no-syncSkip pushing local files before connecting

Interactive terminal

cassian ssh
Opens a terminal. Your local files are synced to /workspace before connecting, then stay in sync both ways while you are connected. Edit locally in VS Code, see the changes on the GPU immediately. Edit on the GPU, changes appear locally. Type exit to disconnect.

Non-interactive (scripting)

cassian ssh "nvidia-smi"
cassian ssh "cat /workspace/results.txt"
Equivalent to cassian exec. Useful when you are already thinking in terms of SSH-like usage.

Skipping sync

cassian ssh --no-sync
Connects without pushing files first. Use this when connecting from a different machine, when your files are already in sync, or when you just want a quick look without triggering a push.

Tips

  • Use nohup python train.py & for jobs that should survive disconnection
  • Changes to cassian.yaml while connected are hot-reloaded (port forwarding updates live)
  • Ports declared in cassian.yaml are automatically forwarded during cassian ssh