The workspace command (alias: ws) lets you manage interactive development environments on VESSL Cloud. Workspaces provide persistent compute sessions you can pause and resume without losing data.
list
List all workspaces in the current team.
| Flag | Default | Description |
|---|
--all | false | Show all workspaces in the team (not just yours) |
show
Display detailed information about a specific workspace.
vesslctl workspace show <slug>
| Argument | Description |
|---|
slug | Slug of the workspace to inspect |
create
Create a new workspace with a specified cluster, resource spec, and container image.
vesslctl workspace create --name my-workspace --cluster <slug> --resource-spec <slug> --image <image>
| Flag | Required | Description |
|---|
--name | Yes | Name for the workspace |
--cluster | Yes | Cluster slug to run the workspace on |
--resource-spec | Yes | Resource spec slug (GPU type, count, CPU, memory) |
--image | No | Container image to use |
--init-script | No | Shell script to run on workspace startup |
--object-volume | No | Mount an Object storage volume as SLUG:MOUNT_PATH (repeatable) |
--cluster-volume | No | Mount a Cluster storage volume as SLUG:MOUNT_PATH (repeatable) |
vesslctl workspace create \
--name my-workspace \
--cluster <cluster-name> \
--resource-spec <spec-name> \
--image quay.io/vessl-ai/torch:2.9.1-cuda13.0.1-py3.13-slim
Run vesslctl cluster list and vesslctl resource-spec list to see available clusters and GPU specs.
start
Resume a previously paused workspace.
vesslctl workspace start <slug>
| Argument | Description |
|---|
slug | Slug of the workspace to resume |
pause
Pause a running workspace. Billing stops while paused, but all data is preserved.
vesslctl workspace pause <slug>
| Argument | Description |
|---|
slug | Slug of the workspace to pause |
terminate
Permanently delete a workspace and all associated data.
vesslctl workspace terminate <slug>
| Flag | Short | Description |
|---|
--yes | -y | Skip confirmation prompt |
vesslctl workspace terminate my-workspace-abc123 --yes
logs
View logs from a workspace.
vesslctl workspace logs <slug>
| Flag | Short | Default | Description |
|---|
--limit | | 100 | Number of log lines to return |
vesslctl workspace logs my-workspace-abc123 --limit 500
ssh
Open an SSH session into a running workspace.
vesslctl workspace ssh <slug>
| Flag | Short | Description |
|---|
--key | -i | Path to SSH private key file |
vesslctl workspace ssh my-workspace-abc123 -i ~/.ssh/id_rsa
