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

# vesslctl config, auth, billing & utility

> CLI 설정, 인증 관리, 결제 상태 확인, vesslctl 업데이트 방법을 알아봐요.

이 명령어들은 CLI 설정, 인증, 계정 결제, 유틸리티 작업을 처리해요.

## 설정 명령어

### config show

현재 CLI 설정을 표시해요. 설정 파일 경로, 인증 상태, 해석된 컨텍스트(조직, 팀, API URL)와 그 출처를 포함해요.

```bash theme={null}
vesslctl config show
```

**출력 예시:**

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

설정 값을 지정해요.

```bash theme={null}
vesslctl config set <key> <value>
```

| 키               | 설명                               |
| --------------- | -------------------------------- |
| `default_org`   | 모든 명령어의 기본 조직                    |
| `default_team`  | 모든 명령어의 기본 팀                     |
| `output_format` | 출력 형식(`table`, `json`, 또는 `csv`) |
| `api_url`       | VESSL Cloud API 엔드포인트 URL        |

**예시:**

```bash theme={null}
vesslctl config set output_format json
vesslctl config set default_org vessl-ai
```

## 인증 명령어

### auth login

VESSL Cloud에 인증해요. 기본 플로우는 브라우저로 OAuth를 열고, 브라우저를 사용할 수 없을 때 이메일과 비밀번호 로그인으로 폴백해요.

```bash theme={null}
vesslctl auth login
```

| 플래그          | 약어 | 설명                            |
| ------------ | -- | ----------------------------- |
| `--web`      |    | 브라우저 OAuth만 사용(비밀번호 폴백 비활성화)  |
| `--password` |    | 브라우저 OAuth 대신 이메일/비밀번호 로그인 사용 |

**예시:**

```bash theme={null}
# 기본 브라우저 OAuth (비밀번호 폴백 포함)
vesslctl auth login

# 비밀번호 기반 로그인
vesslctl auth login --password
```

<Note>
  **VESSL Cloud Workspace 내부에서는** `VESSLCTL_ACCESS_TOKEN`이나 `SIDECAR_INITIAL_ACCESS_TOKEN`이 설정돼 있을 때 `vesslctl auth login`이 인터랙티브 로그인을 건너뛰고 안내 메시지만 출력해요. 워크로드 토큰을 무시하고 새로 로그인하려면 `--web` 또는 `--password`를 명시적으로 넘겨 주세요.
</Note>

### auth logout

로컬 머신에서 저장된 자격 증명을 제거해요.

```bash theme={null}
vesslctl auth logout
```

### auth status

현재 인증 상태를 표시해요. 사용자 이름, 이메일, 토큰 유효성, 조직/팀 컨텍스트, 조직 목록을 포함해요.

```bash theme={null}
vesslctl auth status
```

**출력 예시:**

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

현재 크레딧 잔액, 소모율, 예상 잔여 시간을 표시해요.

```bash theme={null}
vesslctl billing show
```

## 유틸리티 명령어

### version

vesslctl 버전을 출력해요.

```bash theme={null}
vesslctl version
```

루트 명령어의 `--version` 플래그를 사용할 수도 있어요:

```bash theme={null}
vesslctl --version
```

### install

현재 `vesslctl` 바이너리를 PATH에 있는 디렉터리에 복사해요. 설치 스크립트로 처음 다운로드한 후 영구적으로 사용하려면 이 명령어를 실행해 주세요.

```bash theme={null}
vesslctl install
```

| 플래그     | 설명                                               |
| ------- | ------------------------------------------------ |
| `--dir` | 대상 디렉터리(기본값: `/usr/local/bin` 또는 `~/.local/bin`) |

**예시:**

```bash theme={null}
# 기본 위치에 설치
vesslctl install

# 커스텀 디렉터리에 설치
vesslctl install --dir ~/bin
```

<Note>
  기본 디렉터리에 루트 권한이 필요한 경우 `sudo vesslctl install`을 사용해 주세요.
</Note>