rag-ls-images Command

1st chunk of `docs/commands/ls-images.txt`

9d3da56cb994e45e110b6447b879c98e4b72a35d9f05fa1700000001000002c5

rag-ls-images(1)
==========

NAME
----
rag-ls-images - Show information about images

SYNOPSIS
--------
[verse]
'rag ls-images' [--stat-only | --uid-only] [--json | -j] [--abbrev <n=9>]
            [<uid>..]

DESCRIPTION
-----------
Run `rag help uid-query` to read how uid-query works. If the uid is not of
an image, it dies.

Instead of showing the full 64-byte uid, it shows the first `n` bytes of uid,
where `n` is set by `--abbrev` option. Unlike git, it doesn't use any
heuristics to guarantee that the abbreviated uid is unique.

If `--json` is set, it dumps a valid json to stdout. Its schema is,

- no flags: `[image: object]`
- `--uid-only`: `[uid: string]`
- `--stat-only`: `{ "images": integer }`

Title: rag-ls-images Command

Summary

The rag-ls-images command is used to display detailed information about images, allowing for various output options such as stat-only, uid-only, and json output, with customizable uid abbreviation, enabling users to tailor the output to their specific needs and preferences.