> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trycassian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cassian ssh

> Open a terminal inside the instance.

## Usage

```bash theme={null}
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

| Flag        | Description                                |
| ----------- | ------------------------------------------ |
| `--no-sync` | Skip pushing local files before connecting |

## Interactive terminal

```bash theme={null}
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)

```bash theme={null}
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

```bash theme={null}
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`