Command Options

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

Option	Details
-h, --help	Output usage information
--version	Output the version number

Setup options

Option	Details
--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-path	CSV file to run the collection with
--json-file-path	Path to the JSON data file
--iteration-count [number]	Number of times to run the collection
-r	Indicates a recursive run [boolean] [default: false]

Request options

Option	Details
--delay [number]	Delay between each requests (in milliseconds)
--tests-only	Only run requests that have tests or active assertions
--bail	Stop 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)
--parallel	Run requests in parallel order

SSL & Security options

Option	Details
--cacert [string]	CA certificate to verify peer against
--ignore-truststore	Use custom CA certificate exclusively and ignore default truststore [boolean] [default: false]
--client-cert-config	Path to the Client certificate config file used for securing the connection
--insecure	Allow insecure server connections
--disable-cookies	Automatically save and send cookies with requests [boolean] [default: false]
--noproxy	Disable all proxy settings (both collection-defined and system proxies) [boolean] [default: false]

Output & Reporting options

Option	Details
-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-headers	Skip all headers in the report [boolean] [default: false]
--reporter-skip-headers	Skip specific headers in the report [array] [default: []]
--reporter-skip-request-body	Omits request bodies from reports [boolean] [default: false]
--reporter-skip-response-body	Omits response bodies from reports [boolean] [default: false]
--reporter-skip-body	Shorthand: 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.

Option	Details
-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.
--insecure	Skip 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.

```bash copy bru run

You can also run specific files or folders:

```bash copy
# Run a single file
bru run request.bru

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

# Run a folder
bru run <folder-name>

# Run multiple folders
bru run <folder-1-name> <folder-2-name>

# Mix of files and folders
bru run <folder-1-name> request1.bru <folder-2-name> 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. Command Examples - 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 <sup>↗</sup>