inspect
Scans a folder recursively and prints three tables: supported files by extension, supported files by type, and unsupported files by extension. Use it as a dry-run before upload-folder, monitor, or ingest-pst.
inspect runs entirely locally — it does not contact a workspace.
Usage
curiosity-cli inspect --path /mnt/shares/docs
Options
| Flag | Alias | Required | Description |
|---|---|---|---|
--path |
-p |
yes | Folder to scan recursively. |
Sample output
Measuring folder '/mnt/shares/docs', please wait....................
Summary of supported files by extension
+-----------+--------+----------------+
| Extension | Count | Size in bytes |
+-----------+--------+----------------+
| pdf | 12,400 | 8,920,481,210 |
| docx | 6,210 | 1,103,209,448 |
| xlsx | 2,011 | 220,402,001 |
+-----------+--------+----------------+
Summary of supported files by type
+-----------+--------+----------------+
| File Type | Count | Size in bytes |
+-----------+--------+----------------+
| Document | 18,610 | 10,023,690,658 |
| Sheet | 2,011 | 220,402,001 |
+-----------+--------+----------------+
Summary of unsupported files by extension
+-----------+--------+----------------+
| Extension | Count | Size in bytes |
+-----------+--------+----------------+
| iso | 12 | 40,002,310,000|
| bak | 901 | 2,109,440,000|
+-----------+--------+----------------+
The unsupported table is the one most teams care about — it tells you which file types you'd skip if you ran upload-folder against the same path, and lets you decide whether to pre-process them (extract archives, convert images, etc.) or filter them out with --extensions.
See also
upload-folder— actually ingest the folder. Accepts--extensionsto filter.monitor— continuous version ofupload-folder.ingest-pst— same idea but for PST files containing emails.