Skip to main content


mergestat -h

Will output the most up to date usage instructions for your version of the CLI. Typically the first argument is a SQL query string:

mergestat "SELECT * FROM commits"

Your current working directory will be used as the path to the git repository to query by default. Use the --repo flag to specify an alternate path, or even a remote repository reference (http(s) or ssh). mergestat will clone the remote repository to a temporary directory before executing a query.

You can also pass a query in via stdin:

cat query.sql | mergestat

By default, output will be an ASCII table. Use --format json or --format csv for alternatives. Use -v to print execution logs to stderr. This can be useful for understanding what API calls a query may be making, or similar runtime information. See -h for all the options.