Learn CLI command flags

Written by Marcelo B ( Updated on June 18th, 2026 )

Updated on June 18th, 2026

CLI command flags serves to modify the command's behavior. Some flags are optional.

Example: you need to specify your browser type when using create_profile, such as --browser-type mimic.

Error message: required flags are missing for ProfileID `--values`

How to use flags

If you need to apply the same flag with various values, you need to type it twice. E.g., you want to remove several folders, let's say folder X and Y. Parameter values is used for specifying the folder id for that command. In that case, your prompt to the CLI will be the following:
```
./xcli remove-folder --values X --values Y
```
CLI will warn you if flags are missing. You can use xcli command-name -h for full help.

Flag reference list for “profile-create” command

Some commands can be overwhelming due to the amount of flags. One of them is profile-create. Here is the list of flags which you can use there:

Required flags
`--name`	name of new profile
`--browser-type`	browser type: `mimic` or `stealthfox`
`--launcher-info`	get information about the running launcher
`--os-type`	OS type: Android, Linux, macOS or Windows
Other flags
`--audio-masking`	audio masking mode: `natural` or `mask` (default: `natural`)
`--auto-update`	enables auto update of profile (default: `true`)
`--cloud`	stores profile data in the cloud. No need to specify value. Simply including the parameter makes it true
`--fonts-masking`	fonts masking mode: `natural` or `mask` (default: `natural`)
`--geolocation-popup`	geolocation popup behavior: `allow`, `block` or `prompt` (default: `prompt`)
`--graphics-masking`	graphics masking mode: `natural` or `mask` (default: `natural`)
`--graphics-noise`	graphics noise mode: `natural` or `mask` (default: `natural`)
`--localization-masking`	localization masking mode: `natural` or `mask` (default: `natural`)
`--media-devices-masking`	media device masking mode: `natural` or `mask` (default: `natural`)
`--navigator-masking`	navigator masking mode: `natural` or `mask` (default: `natural`)
`--ports-masking`	ports masking mode: `natural` or `mask` (default: `natural`)
`--proxy-host`	proxy host
`--proxy-password`	proxy password
`--proxy-port`	proxy port
`--proxy-string`	proxy string in format `host:port:user:password`. If `proxy-string` is used, then `proxy-type` is required too
`--proxy-traffic-saver`	false by default. It tells the browser if it should save on proxy traffic by not showing media. Can be used only if we are using proxy is configured.
`--proxy-type`	proxy type: `http`, `https`, `socks5`, `url`. If we are using parameters to set proxy, this is required. If we create a profile via template then this is not required
`--proxy-username`	proxy username
`--screen-masking`	screen masking mode: `natural` or `mask` (default: `natural`)
`--template`	template file
`--timezone-masking`	timezone masking mode: `natural` or `mask` (default: `natural`)
`--webrtc-masking`	webrtc masking mode: `natural`, `mask` or `disabled` (default: `natural`)

Basic automation with CLI

Learn CLI command flags

How to use flags

Flag reference list for “profile-create” command

Required flags

Other flags

Related articles