이 명령어들은 CLI 설정, 인증, 계정 결제, 유틸리티 작업을 처리해요.
설정 명령어
config show
현재 CLI 설정을 표시해요. 설정 파일 경로, 인증 상태, 해석된 컨텍스트(조직, 팀, API URL)와 그 출처를 포함해요.
출력 예시:
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
설정 값을 지정해요.
vesslctl config set <key> <value>
| 키 | 설명 |
|---|
default_org | 모든 명령어의 기본 조직 |
default_team | 모든 명령어의 기본 팀 |
output_format | 출력 형식 (table, json, 또는 csv) |
api_url | VESSL Cloud API 엔드포인트 URL |
vesslctl config set output_format json
vesslctl config set default_org vessl-ai
인증 명령어
auth login
VESSL Cloud에 인증해요. 기본적으로 브라우저에서 OAuth를 열거나, 비밀번호 기반 로그인을 사용할 수 있어요.
| 플래그 | 약어 | 설명 |
|---|
--web | | 브라우저 기반 OAuth 로그인 강제 (기본값) |
--password | | 브라우저 OAuth 대신 이메일/비밀번호 로그인 사용 |
# 기본 브라우저 OAuth
vesslctl auth login
# 비밀번호 기반 로그인
vesslctl auth login --password
auth logout
로컬 머신에서 저장된 자격 증명을 제거해요.
auth status
현재 인증 상태를 표시해요. 사용자 이름, 이메일, 토큰 유효성, 조직/팀 컨텍스트, 조직 목록을 포함해요.
출력 예시:
Username: wayne
Email: wayne@vessl.ai
Token: Valid (expires 2026-05-01)
Organization: vessl-ai
Team: ml-research
ORGANIZATIONS
vessl-ai (current)
personal
결제 명령어
billing show
현재 크레딧 잔액, 소모율, 예상 잔여 시간을 표시해요.
유틸리티 명령어
version
vesslctl 버전을 출력해요.
루트 명령어의 --version 플래그를 사용할 수도 있어요:
install
현재 vesslctl 바이너리를 PATH에 있는 디렉토리에 복사해요. 설치 스크립트로 처음 다운로드한 후 영구적으로 사용하려면 이 명령어를 실행해 주세요.
| 플래그 | 설명 |
|---|
--dir | 대상 디렉토리 (기본값: /usr/local/bin 또는 ~/.local/bin) |
# 기본 위치에 설치
vesslctl install
# 커스텀 디렉토리에 설치
vesslctl install --dir ~/bin
기본 디렉토리에 루트 권한이 필요한 경우 sudo vesslctl install을 사용해 주세요.
