These commands handle CLI configuration, authentication, account billing, and utility operations.
Config commands
config show
Display the current CLI configuration, including the config file path, authentication status, and resolved context (organization, team, API URL) with their sources.
Example output:
Config File: ~/.config/vesslctl/config.yaml
Auth Status: logged in
default_org (config): vessl-ai
default_team (config): ml-research
API URL (resolved): https://api.cloud.vessl.ai (from default)
Output (resolved): table (from default)
Org (resolved): vessl-ai (from config)
Team (resolved): ml-research (from config)
config set
Set a configuration value.
vesslctl config set <key> <value>
| Key | Description |
|---|
default_org | Default organization for all commands |
default_team | Default team for all commands |
output_format | Output format (table, json, or csv) |
api_url | VESSL Cloud API endpoint URL |
vesslctl config set output_format json
vesslctl config set default_org vessl-ai
Auth commands
auth login
Authenticate with VESSL Cloud. Opens a browser for OAuth by default, or use password-based login.
| Flag | Short | Description |
|---|
--web | | Force browser-based OAuth login (default) |
--password | | Use email and password login instead of browser OAuth |
# Default browser OAuth
vesslctl auth login
# Password-based login
vesslctl auth login --password
auth logout
Remove saved credentials from the local machine.
auth status
Display your current authentication status, including username, email, token validity, org/team context, and organization list.
Example output:
Username: wayne
Email: wayne@vessl.ai
Token: Valid (expires 2026-05-01)
Organization: vessl-ai
Team: ml-research
ORGANIZATIONS
vessl-ai (current)
personal
Billing command
billing show
Display your current credit balance, burn rate, and estimated remaining hours.
Utility commands
version
Print the vesslctl version.
You can also use the --version flag on the root command:
install
Copy the current vesslctl binary to a directory in your PATH for permanent use. Useful after downloading vesslctl for the first time via the install script.
| Flag | Description |
|---|
--dir | Target directory (default: /usr/local/bin or ~/.local/bin) |
# Install to default location
vesslctl install
# Install to a custom directory
vesslctl install --dir ~/bin
If the default directory requires root access, use sudo vesslctl install.
