images

List images in the project. Images are the filesystem snapshots that sandboxes run from – every non-disposable contree run produces a new one.

Examples

# List all images
contree images

# Filter by tag prefix
contree images --prefix=ubuntu

# Only tagged images
contree images --tagged

# Images created in the last hour
contree images --since=1h

# Find a specific image by UUID prefix
contree images --uuid=3f2a7b

# JSON output for scripting
contree -f json images --tagged | jq -r '.tag'

Help output

$ contree images --help usage: contree images [-h] [--prefix PREFIX] [-i UUID] [-a] [--since SINCE] [--until UNTIL]                       {list,ls,import} ... List and import sandbox images. Without a subcommand, lists images (same as ``images list``). Subcommands:   list (ls)     List images with filtering and pagination   import        Import image from a container registry positional arguments:   {list,ls,import}     list (ls)           List images     import              Import image from container registry options:   -h, --help            show this help message and exit   --prefix PREFIX       Filter by tag prefix   -i UUID, --uuid UUID  Filter by image UUID   -a, --all             Include untagged images (default: tagged only)   --since SINCE         Parse +/- intervals (bare seconds or smhdMy) or ISO/date to UTC datetime.   --until UNTIL         Show images before. Parse +/- intervals (bare seconds or smhdMy) or                         ISO/date to UTC datetime. examples:   contree images --prefix=ubuntu   contree images list --all   contree images import ubuntu:latest   contree images import ubuntu:{latest,noble,jammy}   contree images import ghcr.io/owner/image:tag for coding agents:   `images` / `images list` is read-only   `images import` spawns async import operations and polls until completion   supports brace expansion for batch imports   Ctrl+C cancels all active import operations agent note:   Before using this command in an automated workflow, read:     contree agent

Filtering

--prefix matches the beginning of the tag string. This is useful for browsing available base images:

contree images --prefix=python
contree images --prefix=common/

--since and --until accept either ISO timestamps or duration intervals like 1h, 30m, 7d.

See also