CLIΒΆ

When you install the reference implementation, it creates a console script pathsjson with the following usage:

optional arguments:
  -h, --help           show this help message and exit
  --init               Create a .paths.json file in the cwd
  --init-globals       Create the global paths.json file
  --make-exports       Print exports for Makefile eval
  --print-global-path  Print global paths.json file path
  --shell-exports      Print exports for shell

You'll notice the reference to a global path.json file. This file lets you define user-level defaults. It's useful when you do contract work or group related projects onto one disk. For example, I may define a CONTRACT-99 directory in the global paths.json file. Then, all my data goes onto a portable harddrive for that contract.

The --shell-exports switch prints the resolved paths to the console with with export and quoting. This lets you use the paths in your shell session, via,

eval $(pathsjson --shell-exports)