Command Line Interface¶

MATE provides a command-line interface for validating the runtime environment, inspecting resolved configuration, viewing environment variables, inspecting registered JIT or AOT modules, exporting compile commands for development tools, clearing the JIT cache, and replaying captured dumps.

Quick Reference¶

View all available commands:

mate --help

If the mate executable entrypoint is not available in your environment, use python -m mate --help and python -m mate ... for supported subcommands.

For the full command reference, see MATE CLI Reference.

Environment and Status¶

Use these commands first after installation or when runtime behavior does not match expectations.

Validate the runtime environment:

mate check

Inspect resolved configuration, package versions, detected devices, architecture resolution, and JIT or AOT state:

mate show-config

Show the MATE-related environment variables visible to the current shell:

mate env

JIT and Development Tools¶

Inspect the registered JIT and AOT modules without compiling them:

mate module-status
mate module-status --detailed

List all registered modules, or inspect one module in more detail:

mate list-modules
mate list-modules module_name

Export compile_commands.json for IDEs and language servers such as clangd or ccls:

mate export-compile-commands
mate export-compile-commands my_compile_commands.json

Cache Management¶

Clear the runtime JIT cache without removing packaged AOT libraries:

mate clear-cache

Replay Recorded Calls¶

Replay API dumps captured with Level 10 logging.

List recorded dump directories under a dump root:

mate list-dumps mate_dumps/

Replay all recorded calls in a dump session:

mate replay --dir mate_dumps/

Replay a single recorded call:

mate replay --dir mate_dumps/<dump_directory>

mate replay accepts either the dump root directory or a single dump subdirectory.