tag - Tag or untag an image

Assign or remove a tag from an image. Tags are human-readable names that make images easier to reference.

Examples

# Tag an image
contree tag 3f2a7b... my-app:v1.0

# Remove a tag
contree tag 3f2a7b... my-app:v1.0 --delete

# Use the tagged image
eval $(contree use tag:my-app:v1.0)

Help output

$ contree tag --help usage: contree tag [-h] [-U] ARG [ARG ...] Assign or remove a tag from an image. Tags provide human-readable names for image UUIDs, making them easier to reference in commands like `contree use tag:NAME`. With one argument, tags the current session image. With two arguments, the first is the image reference and the second is the tag. Use -U/--delete/--rm to remove a tag instead of assigning one. positional arguments:   ARG                 TAG (current image) or IMAGE_REF TAG options:   -h, --help          show this help message and exit   -U, --delete, --rm  Remove tag from image examples:   contree tag python-dev:latest            # tag current session image   contree tag UUID python-dev:latest       # tag specific image by UUID   contree tag tag:alpine:latest my-alpine  # re-tag by reference   contree tag -U UUID my-tag               # remove a tag (or --delete/--rm) for coding agents:   mutating command   default action assigns tag; use --delete to remove mapping agent note:   Before using this command in an automated workflow, read:     contree agent

Usage

Tags are free-form strings. A common convention is scope/purpose:version:

contree tag UUID ubuntu-with-curl:latest
contree tag UUID my-project/dev-env:v2

Once tagged, reference the image anywhere with the tag: prefix:

contree use tag:ubuntu-with-curl:latest

Tagging an image that already has a different tag replaces the old tag.

See also