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.
Syntax
Usage: curiosity-cli inspect --path <dir>
curiosity-cli inspect --path /mnt/shares/docs
Options
| Option | Description |
|---|---|
--path |
Folder to scan recursively. Alias -p. Required. |
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.
Remarks
- Use
inspectas a dry run beforeupload-folder,monitor, oringest-pstto see what would and would not be ingested. - It runs entirely locally and never contacts a workspace, so no token is required.
- Pay attention to the unsupported-files table to decide what to pre-process or filter out.
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.