Configuration¶
Precedence¶
A command-line option overrides its environment variable, which overrides the built-in default. Unset and empty environment variables preserve the default.
These are options for the existing archivist CLI. The separate
archivist-mcp adapter uses explicit startup
root allowlists and bounded-read limits, not CLI apply or logging settings.
MCP tools cannot change that policy or execute an operation.
Command-line options¶
Option |
Default |
Purpose |
|---|---|---|
|
Prompt |
Folder to process |
|
Off |
List image files and ZIP entries |
|
Off |
List, approve, extract, then transfer pictures |
|
Off |
Skip standard cleanup; MACOSX cleanup remains enabled unless |
|
Unset |
Flat, source-disjoint transfer destination; relative to current directory |
|
Off |
Copy rather than move; requires a picture-transfer action |
|
Image catalog |
Comma-separated case-insensitive image extensions |
|
Off |
Keep ZIP archives after extraction |
|
Off |
Keep AppleDouble files and folders |
|
Off |
Keep Synology |
|
Off |
Keep |
|
Off |
Keep Windows |
|
Off |
Keep Windows |
|
On |
Recursively remove |
|
Off |
Keep |
|
|
Largest AppleDouble file to remove |
|
Off |
Clear read-only flags before removal |
|
Off |
Use the Recycle Bin or Trash |
|
Off |
Extract, move, and remove files |
|
On without apply |
Preview only; overrides |
|
|
Choose the report file or folder; image workflows use |
|
Off |
Disable file logging |
Environment variables¶
Variable |
Option |
Default |
|---|---|---|
|
|
Prompt, or |
|
|
|
|
|
|
|
|
|
|
|
Unset |
|
|
|
|
|
All supported image extensions |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Logging options |
|
Boolean variables accept true/false, 1/0, yes/no, and on/off.
Both flag vocabularies share the *_IMAGES variables; there are no *_PICTURES
variables. --copy and --destination require a move action, and --filter
requires an image action. Applying a transfer requires a destination; preview
does not. Copy mode rejects --force/--send-to-bin. No variable grants human
approval. See Usage for the extension catalog and workflow rules.
Logging values¶
ARCHIVIST_LOG_FILE supports three modes:
Set a file or folder path to choose the destination
Use
trueto keep the workflow’s defaultreport.logorpictures.logUse
falseto disable file logging
Examples¶
$env:ARCHIVIST_PARENT_FOLDER = "C:\photos"
$env:ARCHIVIST_APPLY = "true"
$env:ARCHIVIST_SEND_TO_BIN = "true"
archivist
ARCHIVIST_PARENT_FOLDER=/mnt/photos ARCHIVIST_APPLY=true archivist