CommandOptions

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: []]

Import options

Option	Details
--source [string]	Path to the OpenAPI specification file (YAML or JSON)
--output-file [string]	Output file to export as Bruno collection in JSON format
--collection-name [string]	Name for the imported collection from OpenAPI

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

---

title: “Command Options”

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 ^↗