rag-ls-files Command Reference

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

9a30ebd4cab3898b8f3ac3aea5280441b67749e5c10dcb6f00000001000002c5

rag-ls-files(1)
==========

NAME
----
rag-ls-files - Show information about files

SYNOPSIS
--------
[verse]
'rag ls-files' [--name-only | --stat-only | --uid-only]
            [--staged | --processed] [--json | -j] [<uid>..]

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

If multiple files are matched, it shows the information about all the matched
files.

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

- no flags: `[file_schema: object]`
- `--uid-only`: `[uid: string]`
- `--name-only`: `[name: string]`
- `--stat-only`: `{ "total files": integer, "staged files": integer, "processed files": integer }`

Title: rag-ls-files Command Reference

Summary

The rag-ls-files command displays information about files, allowing for various output formats and filtering options, including JSON output and querying by UID, with parameters to control the level of detail and type of data shown, such as file names, statistics, and user IDs.