vesslctl tag

Create and manage tags to organize and filter jobs.

The tag command lets you create, list, and delete tags at the organization level. Tags can be attached to jobs for filtering and categorization.

create

Create a new tag in your organization.

vesslctl tag create <value>

Argument	Description
value	Display name for the tag

Flag	Default	Description
--color	#808080	Tag color in hex format (for example, #ff0000)

Example:

vesslctl tag create "experiment-v2" --color "#3b82f6"

list

List all tags in your organization.

vesslctl tag list

Example output:

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

Delete a tag by its value or slug.

vesslctl tag delete [value]

Argument	Description
value	Tag value to delete (positional, mutually exclusive with --slug)

Flag	Short	Description
--slug	-s	Delete tag by slug instead of value

Example:

# Delete by value
vesslctl tag delete "experiment-v2"

# Delete by slug
vesslctl tag delete -s tag-abc123

---

Job tag commands

Tags can be attached to and detached from jobs using vesslctl job tag. When you attach a tag value that does not exist yet, it is created automatically.

job tag attach

Attach a tag to a job.

vesslctl job tag attach <slug> [tagValue]

Argument	Description
slug	Slug of the job
tagValue	Tag value to attach (auto-creates if not exists)

Flag	Short	Description
--slug	-s	Attach tag by slug instead of value

Example:

# Attach by value (auto-creates the tag if needed)
vesslctl job tag attach job-abc123 "nightly-run"

# Attach by slug
vesslctl job tag attach job-abc123 -s tag-def456

job tag detach

Detach a tag from a job.

vesslctl job tag detach <slug> [tagValue]

Argument	Description
slug	Slug of the job
tagValue	Tag value to detach

Flag	Short	Description
--slug	-s	Detach tag by slug instead of value

Example:

vesslctl job tag detach job-abc123 "nightly-run"

Use vesslctl job create --tag "my-tag" to attach tags at job creation time. The --tag flag is repeatable and auto-creates tags that don’t exist.