imglife app

Synopsis

imglife app list [flags]
imglife app purge [flags]

Manages applicative build records stored in the Package Registry.

app list

Lists all build records published by applicative teams via imglife register.

Flags

Flag	Default	Description
--detailed	false	Show full record details (base, revision, platforms)
--output string	text	Output format: text or json
--output-file string	—	Write output to a file
--project string	—	Filter records by project path (substring match)

Examples

# List all app records
imglife app list

# Filter by project
imglife app list --project myteam/myservice

# Detailed view
imglife app list --detailed

# JSON output
imglife app list --output json

# Export to file
imglife app list --output json --output-file records.json

Sample output

myteam/myservice
  myservice:1.2.0   base: alpine:3.21.3-core1.0.0   built: 2026-04-01
  myservice:1.1.0   base: alpine:3.20.6-core1.0.0   built: 2026-02-15

myteam/api
  api:3.0.0         base: golang:1.22.3-core1.0.0   built: 2026-03-20

app purge

Removes stale build records from the Package Registry.

Flags

Flag	Default	Description
--keep integer	10	Number of most-recent records to keep per image
--dry-run	false	Simulate without deleting
--delete-on-error	false	Also delete records for images that no longer exist in the OCI registry
--project string	—	Limit to records matching this project path

Examples

# Preview: show what would be purged
imglife app purge --dry-run

# Keep 5 most recent records per image
imglife app purge --keep 5

# Also remove orphaned records (images no longer in OCI registry)
imglife app purge --keep 10 --delete-on-error

# Limit to one project
imglife app purge --project myteam/myservice

Exit codes

Code	Meaning
0	Success
1	Error