CLI Reference
Commands
The convenience commands are the primary user-facing interfaces:
dist [OPTIONS] [LOCATION]
distcache [OPTIONS]
The distman suite command provides equivalent namespaced interfaces:
distman dist [OPTIONS] [LOCATION]
distman cache [OPTIONS]
distman --version
Distribution
dist [OPTIONS] [LOCATION]
LOCATION is the directory containing dist.json and defaults to the current
directory.
| Option | Meaning |
|---|---|
-t, --target TARGET... |
Select target names; wildcards are supported |
-s, --show |
Show active distributed versions only |
-c, --commit HASH |
Point selected targets to a deployed commit |
-n, --number NUMBER |
Point selected targets to a version number |
--reset |
Point selected targets to the latest version |
--delete |
Delete selected deployed targets or versions |
-y, --yes |
Accept confirmation prompts |
--all |
Include normally ignored files |
--ignore-missing |
Skip missing source paths |
-f, --force |
Allow operations blocked by source-state checks |
--version-only |
Create the version without changing the active link |
-d, --dryrun |
Report actions without changing files |
-v, --verbose |
Increase output detail; repeat for debug output |
--version |
Print the distman version |
Examples:
dist /path/to/repository --target bin --dryrun
dist --target 'plugin-*' --yes
dist --show
dist --target tools --number 3
dist --target tools --delete --number 1 --dryrun
--commit, --number, and --reset are mutually exclusive.
Cache Management
distcache [OPTIONS]
distman cache [OPTIONS] is equivalent.
| Option | Meaning |
|---|---|
--src PATH |
Deployment source; defaults to DEPLOY_ROOT |
--dst PATH |
Local destination; defaults to CACHE_ROOT |
--workers N |
Parallel copy threads; defaults to 4× CPUs, capped at 32 |
--delete |
Delete the cache |
-p, --prune |
Remove unreferenced cached versions |
--diff |
Show differences without copying |
-t, --ttl SECONDS |
Remote epoch-check TTL; 0 always checks |
-f, --force |
Refresh regardless of TTL and epoch state |
-d, --dryrun |
Check staleness without changing files |
Examples:
distcache --dryrun
distcache --ttl 0
distcache --diff
distcache --prune --dryrun
distcache --src /studio/apps/prod --dst /var/tmp/apps