imglife images

Synopsis

imglife images [flags]

Lists images present in the OCI registry. By default, shows only images declared in the build.images configuration. With --all, discovers all images via the OCI _catalog API.

Flags

Flag	Default	Description
--all	false	Discover all images in the registry via _catalog

Examples

# List configured images
imglife images

# Discover all images in the registry
imglife images --all

Output

registry.example.com/bases/alpine    [3.21.3-core1.0.0, 3.20.6-core1.0.0]
registry.example.com/bases/golang    [1.22.3-alpine3.21-core1.0.0]
registry.example.com/mirrors/alpine  [3.21.3, 3.21.2, 3.20.6]

Use cases

• Audit — discover images that exist in the registry but are not managed by imglife.
• Orphan detection — find images no longer declared in build.images.
• Debug — verify that a sync or build produced the expected tags.

The --all flag uses the OCI Distribution Specification’s _catalog endpoint. Not all registries support this endpoint (Docker Hub does not; most self-hosted registries do).