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

# Repo tag list

# 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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag list <repo-name>
vers repo tag list <repo-name> -q
vers repo tag list <repo-name> --format json
```

## Options

| Option          | Description                         |
| --------------- | ----------------------------------- |
| `-q`, `--quiet` | Output only tag names, one per line |
| `--format`      | Output format: `json`               |

## Examples

### Default table

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag list my-app -q
# latest
# known-good
# v1.0
```

### JSON

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag list my-app --format json
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
[
  {
    "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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag list ghost
# Error: Repository not found
```

## See Also

* [`vers repo tag get`](/cli-reference/repo-tag-get)
* [`vers repo tag create`](/cli-reference/repo-tag-create)