Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vers.sh/llms.txt

Use this file to discover all available pages before exploring further.

vers repo tag list

Show every tag in a repository, along with the commit each points at and when it was created or last moved.

Synopsis

vers repo tag list <repo-name>
vers repo tag list <repo-name> -q
vers repo tag list <repo-name> --format json

Options

OptionDescription
-q, --quietOutput only tag names, one per line
--formatOutput format: json

Examples

Default table

vers repo tag list my-app
# Repository: my-app
#
# TAG           COMMIT                                  CREATED              DESCRIPTION
# latest        c7e4a2f1-1234-5678-9abc-def012345678    2026-04-18 14:02:10  Current main build
# known-good    1a2b3c4d-…                              2026-04-10 08:11:00  Last green CI
# v1.0          88ffeedd-…                              2026-03-22 16:00:00  First tagged release

Just names, for scripting

vers repo tag list my-app -q
# latest
# known-good
# v1.0

JSON

vers repo tag list my-app --format json
[
  {
    "tag_id": "…",
    "tag_name": "latest",
    "reference": "my-app:latest",
    "commit_id": "c7e4a2f1-…",
    "created_at": "2026-04-18T14:02:10Z",
    "updated_at": "2026-04-20T09:14:22Z",
    "description": "Current main build"
  }
]

Error Cases

Repository not found

vers repo tag list ghost
# Error: Repository not found

See Also