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

# timoni artifact list

> List the tags of an artifact

## Synopsis

The list command prints a table with the artifact tags and their digests.
By default, the last 100 tags in descending lexical order are listed,
use '--limit 0' to list all tags.

```
timoni artifact list ARTIFACT_URL [flags]
```

## Examples

```sh theme={"system"}
  # Print the last 100 tags and their digests
  timoni artifact ls oci://docker.io/org/app

  # Print the last 10 tags
  timoni artifact list oci://docker.io/org/app --limit 10

  # Print all the tags without digests
  timoni artifact list oci://ghcr.io/org/bundles/app --limit 0 --with-digest=false

  # Print the tags matching a regular expression
  timoni artifact list oci://docker.io/org/app --filter-regex '^1\.'

  # Print the tags matching a semver range
  timoni artifact list oci://docker.io/org/app --filter-semver '>=1.0.0 <2.0.0'

  # Print the tags and digests of an artifact stored in a private repository
  echo $DOCKER_TOKEN | timoni registry login docker.io -u timoni --password-stdin
  timoni artifact list oci://docker.io/org/app

  # Check if a tag is published using the JSON output
  timoni artifact list oci://ghcr.io/org/bundles/app --limit 0 -o json | \
	jq -e --arg t "latest" 'any(.[]; .tag == $t)'

```

## Options

```
      --creds creds            The credentials for the container registry in the format '<username>[:<password>]'.
      --filter-regex string    Filter tags returned from the OCI repository using regular expressions.
      --filter-semver string   Filter tags returned from the OCI repository using semantic version ranges.
  -h, --help                   help for list
      --limit int              Limit the number of tags listed in descending lexical order (0 for all). (default 100)
  -o, --output string          The format in which the tags should be printed, can be 'yaml' or 'json'.
      --with-digest            Resolve the digest of each tag. (default true)
```

## Options inherited from parent commands

```
      --cache-dir string                    Artifacts cache dir, can be disable with 'TIMONI_CACHING=false' env var. (defaults to "$HOME/.timoni/cache")
      --kube-as string                      Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
      --kube-as-group stringArray           Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
      --kube-as-uid string                  UID to impersonate for the operation.
      --kube-certificate-authority string   Path to a cert file for the certificate authority.
      --kube-client-certificate string      Path to a client certificate file for TLS.
      --kube-client-key string              Path to a client key file for TLS.
      --kube-context string                 The name of the kubeconfig context to use.
      --kube-insecure-skip-tls-verify       if true, the Kubernetes API server's certificate will not be checked for validity. This will make your HTTPS connections insecure.
      --kube-server string                  The address and port of the Kubernetes API server.
      --kube-tls-server-name string         Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used.
      --kube-token string                   Bearer token for authentication to the API server.
      --kubeconfig string                   Path to the kubeconfig file.
      --log-color                           Adds colorized output to the logs. (defaults to false when no tty)
      --log-pretty                          Adds timestamps to the logs. (default true)
  -n, --namespace string                    The the namespace scope for the operation. (default "default")
      --registry-insecure                   If true, allows connecting to a container registry without TLS or with a self-signed certificate.
      --timeout duration                    The length of time to wait before giving up on the current operation. (default 5m0s)
```

## See also

* [timoni artifact](/cmd/timoni_artifact)	 - Commands for managing Open Container Initiative (OCI) artifacts