Skip to Content
Get StartedCLI Reference

CLI Reference

matcha run

Run a command and report total GPU energy when it finishes.

matcha wrap

Run a command and append per-step energy data to training output.

matcha monitor

Monitor GPU power continuously. Press Ctrl+C to stop.

matcha runRun a command and report total GPU energy when it finishes.OptionDefaultDescription-​-gpusallGPU indices: all, 0, or 0,1,2-​-interval100NVML polling interval in msmatcha wrapRun a command and append per-step energy to training output.OptionDefaultDescription-​-gpusallGPU indices: all, 0, or 0,1,2-​-interval100NVML polling interval in msmatcha monitorMonitor GPU power continuously. Press Ctrl+C to stop.OptionDefaultDescription-​-gpusallGPU indices: all, 0, or 0,1,2-​-interval100NVML polling interval in ms-​-window1.0Reporting window in seconds

matcha —version

Print the installed version.

VERSION$matcha -​-version