Skip to main content
vesslctl is the command-line interface for VESSL Cloud. Manage workspaces, batch jobs, storage, and team settings from your terminal.
vesslctl help output showing all available commands

โ€‹
Why vesslctl

  • Develop and train in one tool: Launch interactive workspaces for development, then submit batch jobs for training, all with the same CLI
  • Built for teams: Org and team scoping ensures workloads, volumes, and billing are isolated where they need to be
  • Flexible storage: Choose Object storage for cross-cluster access or Cluster storage for high-performance local I/O, and mount volumes into any workload
  • AI-native: Connect VESSL Cloud docs to Claude Code, Cursor, or any MCP-compatible tool so your AI assistant references accurate CLI documentation. See Use with AI tools
  • Scriptable: Combine commands in shell scripts to build hyperparameter sweeps, data pipelines, or autonomous experiment loops

โ€‹
Installation

Supported platforms โ€” macOS 15+, Ubuntu 20.04+, or Windows 10+. No other environment dependencies.
1

Install vesslctl

curl -fsSL https://api.cloud.vessl.ai/cli/install.sh | bash
2

Log in

vesslctl auth login
This opens your browser for OAuth authentication. If a browser is not available, it falls back to email/password login.
3

Verify installation

vesslctl auth status

โ€‹
Global Flags

Every command supports these flags:
FlagShortDescription
--orgOverride the default organization
--team-tOverride the default team
--output-oOutput format: table (default), json, or csv

โ€‹
Set Defaults

After logging in, vesslctl prompts you to select a default organization and team. You can change them anytime: 
vesslctl config set default_org <your-org>
vesslctl config set default_team <your-team>
To view your current configuration: 
vesslctl config show

โ€‹
Shell Completion

The easiest way to enable tab completion is the install subcommand โ€” it detects your shell automatically and writes the script to the right place: 
vesslctl completion install
The command is idempotent, so you can safely re-run it after CLI updates. For zsh, it will let you know if your ~/.zshrc needs an fpath entry.
If you prefer to manage completion scripts yourself:
vesslctl completion bash > /etc/bash_completion.d/vesslctl

โ€‹
Update

Keep vesslctl up to date: 
vesslctl update

โ€‹
Command Overview

CommandDescription
workspaceManage GPU workspaces (create, SSH, pause, terminate)
jobSubmit and manage batch jobs
volumeManage storage volumes
storageList and inspect storage backends
orgSwitch and manage organizations
teamSwitch and manage teams
clusterList available clusters
resource-specList GPU/CPU resource configurations (alias: rs)
tagCreate, list, and attach tags to jobs
skillInstall vesslctl skills for AI coding agents
configManage CLI configuration
authLog in, log out, check auth status
billingView credit balance and burn rate
completionShell completion โ€” install for auto-setup, or bash|zsh|fish for manual
updateUpdate vesslctl to the latest version
installInstall vesslctl to a directory in your PATH