> ## 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 tag

> 태그를 생성하고 관리하여 Job을 분류하고 필터링하는 방법을 알아봐요.

`tag` 명령어를 사용하면 조직 수준에서 태그를 생성, 조회, 삭제할 수 있어요. 태그를 Job에 달아서 분류와 필터링에 활용할 수 있어요.

## create

조직에 새 태그를 생성해요.

```bash theme={null}
vesslctl tag create <value>
```

| 인자      | 설명        |
| ------- | --------- |
| `value` | 태그의 표시 이름 |

| 플래그       | 기본값       | 설명                          |
| --------- | --------- | --------------------------- |
| `--color` | `#808080` | 태그 색상(hex 형식, 예: `#ff0000`) |

**예시:**

```bash theme={null}
vesslctl tag create "experiment-v2" --color "#3b82f6"
```

## list

조직의 모든 태그를 조회해요.

```bash theme={null}
vesslctl tag list
```

**출력 예시:**

```
SLUG                VALUE            COLOR     CREATOR    CREATED
tag-abc123          experiment-v2    #3b82f6   wayne      2026-04-15T09:00:00Z
tag-def456          baseline         #808080   alice      2026-04-14T15:30:00Z
```

## delete

값 또는 slug로 태그를 삭제해요.

```bash theme={null}
vesslctl tag delete [value]
```

| 인자      | 설명                           |
| ------- | ---------------------------- |
| `value` | 삭제할 태그 값(`--slug`과 함께 사용 불가) |

| 플래그      | 단축   | 설명               |
| -------- | ---- | ---------------- |
| `--slug` | `-s` | 값 대신 slug로 태그 삭제 |

**예시:**

```bash theme={null}
# 값으로 삭제
vesslctl tag delete "experiment-v2"

# slug로 삭제
vesslctl tag delete -s tag-abc123
```

***

## Job 태그 명령어

`vesslctl job tag`를 사용하면 Job에 태그를 달거나 떼어낼 수 있어요. 존재하지 않는 태그 값을 달면 자동으로 생성돼요.

### job tag attach

Job에 태그를 달아요.

```bash theme={null}
vesslctl job tag attach <slug> [tagValue]
```

| 인자         | 설명                    |
| ---------- | --------------------- |
| `slug`     | Job의 slug             |
| `tagValue` | 추가할 태그 값(미존재 시 자동 생성) |

| 플래그      | 단축   | 설명               |
| -------- | ---- | ---------------- |
| `--slug` | `-s` | 값 대신 slug로 태그 달기 |

**예시:**

```bash theme={null}
# 값으로 달기(태그 자동 생성)
vesslctl job tag attach job-abc123 "nightly-run"

# slug로 달기
vesslctl job tag attach job-abc123 -s tag-def456
```

### job tag detach

Job에서 태그를 해제해요.

```bash theme={null}
vesslctl job tag detach <slug> [tagValue]
```

| 인자         | 설명        |
| ---------- | --------- |
| `slug`     | Job의 slug |
| `tagValue` | 해제할 태그 값  |

| 플래그      | 단축   | 설명               |
| -------- | ---- | ---------------- |
| `--slug` | `-s` | 값 대신 slug로 태그 해제 |

**예시:**

```bash theme={null}
vesslctl job tag detach job-abc123 "nightly-run"
```

<Tip>
  `vesslctl job create --tag "my-tag"`으로 Job 생성 시 태그를 함께 달 수 있어요. `--tag` 플래그는 반복 사용 가능하며, 존재하지 않는 태그는 자동 생성돼요.
</Tip>