MakerRepo CLI – Global options

These options apply to the mr CLI as a whole, and must appear before any subcommand.

For example:

mr --no-cache artifacts view ...
mr -C .mr-cache generators export ...

Logging

Option	Description
`-l`, `--log-level`	Log level (e.g. DEBUG, INFO, WARNING). Default: from `LOG_LEVEL` env or INFO.
`--build123d-log-level`	Log level for the build123d library. Default: from `BUILD123D_LOG_LEVEL` env or WARNING.
`--log-format`	Logging format (used when rich log is disabled).
`--disable-rich-log`	Use plain text logging instead of rich.

Caching

Most mr commands need to evaluate models (generate CAD models from code, e.g. Build123D). During that process, the CLI can produce cache files, and repeat runs can be significantly faster by reusing cached results.

Common commands that evaluate models:

Artifacts: mr artifacts view, mr artifacts export, mr artifacts snapshot
Generators: mr generators view, mr generators export, mr generators snapshot

Examples:

# Use a project-local cache directory for this run
mr -C .mr-cache artifacts snapshot my_module/my_artifact

# Disable caching for this run (forces full evaluation)
mr --no-cache generators export my_module/my_generator -p @params.json -o out/

Cache files are produced by @cached-decorated functions — see Cached functions. To inspect and prune those cache files, see MakerRepo CLI – Cache.

Option	Description
`-C`, `--cache-dir`	Cache directory (default: `~/.cache/makerrepo` or `XDG_CACHE_HOME/makerrepo`).
`--no-cache`	Disable cache for model evaluation.

Misc

Option	Description
`--version`	Show version and exit.

Shell completion

You can enable tab completion for bash, zsh, or fish:

# Add to your shell config (e.g. .bashrc, .zshrc, config.fish):
eval "$(mr completion bash)"   # bash
eval "$(mr completion zsh)"   # zsh
eval "$(mr completion fish)"  # fish