CLI reference

This page is a simple map of the Gooze commands and the most common flags.

Basic usage

gooze [global flags] <command> [command flags] [paths...]

Most people start with:

gooze run --estimate ./...
gooze run ./...
gooze report view

Global flags

  • -o, --output <dir>: where reports are written (default is usually .gooze-reports)
  • --no-cache: re-test everything (do not reuse cached reports)
  • -x, --exclude <regex>: exclude files by regex (you can repeat this)
  • --coverage-profile <file>: skip mutations on lines not covered by an existing Go coverage profile (run only)
  • -v, --verbose: write extra debug logs
  • --log-output <path>: write logs to a specific file

Tip: flags can change between versions. If you are unsure, run gooze --help or gooze run --help.