Skip to main content
Bruno CLI provides a variety of command options to help you customize your API testing and execution process. These options allow you to specify environments, configure reports, handle security, and much more. Below is a comprehensive list of available options:

​
Options

To use options, add them to the bru run command after you specify the collection file or folder: 
bru run [options]
To view a list of available options for Bruno CLI, run the following command: 
bru run -h

​
Basic options

OptionDetails
-h, --helpOutput usage information
--versionOutput the version number

​
Setup options

OptionDetails
--env [string]Specify environment to run with
--global-env [string]Specify global/workspace-level environment to run with
--workspace-path [string]Specify workspace path when collection is not located at the root
--env-var [string]Overwrite a single environment variable, multiple usages possible
--env-file [string]Path to the environment file (.bru or .json) to use for the collection run
--sandbox [string]Specifies the JavaScript execution sandbox mode: safe (default) or developer.

Note: Starting from v3.0.0, the default is “safe” mode. Use --sandbox=developer to enable Developer Mode features.
--csv-file-pathCSV file to run the collection with
--json-file-pathPath to the JSON data file
--iteration-count [number]Number of times to run the collection
-rIndicates a recursive run [boolean] [default: false]

​
Request options

OptionDetails
--delay [number]Delay between each requests (in milliseconds)
--tests-onlyOnly run requests that have tests or active assertions
--bailStop execution after a failure of a request, test, or assertion
--tags [string]Only run requests that have ALL of the specified tags (comma-separated)
--exclude-tags [string]Skip requests that have ANY of the specified tags (comma-separated)
--parallelRun requests in parallel order

​
SSL & Security options

OptionDetails
--cacert [string]CA certificate to verify peer against
--ignore-truststoreUse custom CA certificate exclusively and ignore default truststore [boolean] [default: false]
--client-cert-configPath to the Client certificate config file used for securing the connection
--insecureAllow insecure server connections
--disable-cookiesAutomatically save and send cookies with requests [boolean] [default: false]
--noproxyDisable all proxy settings (both collection-defined and system proxies) [boolean] [default: false]

​
Output & Reporting options

OptionDetails
-o, --output [string][DEPRECATED] Path to write file results to. Use reporter options instead
-f, --format [string][DEPRECATED] Format of the file results. Use reporter options instead
--reporter-json [string]Path to generate a JSON report
--reporter-junit [string]Path to generate a JUnit report
--reporter-html [string]Path to generate an HTML report
--reporter-skip-all-headersSkip all headers in the report [boolean] [default: false]
--reporter-skip-headersSkip specific headers in the report [array] [default: []]
--reporter-skip-request-bodyOmits request bodies from reports [boolean] [default: false]
--reporter-skip-response-bodyOmits response bodies from reports [boolean] [default: false]
--reporter-skip-bodyShorthand: omits both request and response bodies from reports [boolean] [default: false]

​
Import options

Used with bru import openapi (and related import commands). Run bru import openapi -h for the full list.
OptionDetails
-s, --source [string]Path or URL to the OpenAPI specification (YAML or JSON)
-o, --output [string]Output directory for a collection on disk (folder import)
-f, --output-file [string]Output file path for a single Bruno collection JSON export
-n, --collection-name [string]Name for the imported collection
--collection-format [string]OpenAPI folder import only: bru (classic .bru files) or opencollection (OpenCollection YAML). Default: opencollection.
--insecureSkip TLS verification when --source is an https:// URL
-g, --group-by [string]OpenAPI only: group requests by tags or path (default: tags)

​
Examples

This will run all the requests in your collection.
copy
bru run
You can also run specific files or folders:
copy
# Run a single file
bru run request.bru

# Run multiple files
bru run request1.bru request2.bru

# Run a folder
bru run folder

# Run multiple folders
bru run folder1 folder2

# Mix of files and folders
bru run folder1 request1.bru folder2 request2.bru

​
Next Steps

Now that you’re familiar with the command options, explore these guides to get the most out of Bruno CLI:
  1. Run a Collection - Learn how to execute your collections with the above command options
  2. Import Data - Import OpenAPI and WSDL specifications into Bruno collections
  3. Generate Reports - Create detailed test reports in multiple formats

​
Support

If you encounter any issues or have any feedback or suggestions, please raise them on our GitHub repository ↗