Skip to main content
The Intuned CLI provides development commands to develop, test, and deploy automations locally.

​
Commands

​
Run API

Execute an API Run. 
intuned dev run api <api-name> <parameters> [options]
​
<api-name>
string
required
Name of the API to run. APIs are under the api directory, without the file extension. Use / for nested directories.
​
<parameters>
string
required
Parameters to pass to the API. Accepts a JSON string or a path to a JSON file.
Options 
    --retries <number>
    --auth-session <id>
    --auto-recreate
    --auth-check-retries <number>
    --auth-create-retries <number>
    -o, --output-file <path>
    --proxy <url>
    --timeout <time>
    --start-to-end-timeout <time>
    --headless
    --trace
    --traces-path <path>
    --auth-session-instances-path <path>
    --keep-browser-open
    --cdp-url <url>
    --cdp-browser-name <name>
    --cdp-tab-id <tab_id>
    -h, --help
​
--retries
int
default:"1"
Number of retries for the API if an error in the API execution occurs.
​
--auth-session
string
Auth session ID to use for the run. The auth session files are expected to be in ./auth-sessions-instances/<id>.Must be provided if auth sessions are enabled in Intuned.json. Ignored if not.
​
--auto-recreate
Auto-recreate the auth session if validation fails.Only applicable if auth sessions are enabled in Intuned.json.
​
--auth-check-retries
int
default:"1"
Number of auth session check retries.Only applicable if auth sessions are enabled in Intuned.json.
​
--auth-create-retries
int
default:"1"
Number of auth session create retries (for auto-recreate).Only applicable if auth sessions are enabled in Intuned.json and --auto-recreate is set.
​
-o, --output-file
string
Write the run result to a file instead of stdout. The output is a JSON object containing the result and extended payloads (if applicable).
​
--proxy
string
Proxy URL to use for the browser.
​
--timeout
string
default:"10 mins"
Timeout for each attempt. Accepts milliseconds (integer) or an ms-formatted string (e.g., 30s, 5m, 1h).
​
--start-to-end-timeout
string
default:"12 hours"
Overall timeout from start to end of the command. Accepts milliseconds or an ms-formatted string.
​
--headless
Run the browser in headless mode. By default, the browser runs in headful mode (a visible window).
​
--trace
Capture a Playwright trace of each attempt. Useful for debugging. Traces are saved to ./traces/ by default.
​
--traces-path
string
Custom directory to save trace files. Defaults to traces/.
​
--auth-session-instances-path
string
Custom directory to store/load auth session instance files. Defaults to auth-sessions-instances/.
​
--keep-browser-open
Keep the last browser open after the command completes. Useful for debugging.
​
--cdp-url
string
Chrome DevTools Protocol URL to connect to an existing browser instance. When set, --proxy, --headless, and --keep-browser-open options are ignored.
​
--cdp-browser-name
string
Name of a persistent browser instance (started with dev browser start) to connect to via CDP.
​
--cdp-tab-id
string
Browser tab ID to execute on. Requires --cdp-url or --cdp-browser-name. If not specified, the first tab is used.
​
-h, --help
Display help for command. Will not execute the command.

​
Run AuthSession Create

Executes an AuthSession:Create Run. Auth sessions must be enabled in Intuned.json. 
intuned dev run authsession create <parameters> [options]
​
<parameters>
string
required
Parameters for auth session creation. Accepts a JSON string or a path to a JSON file.
Options 
    --id <id>
    --check-retries <number>
    --create-retries <number>
    --proxy <url>
    --timeout <time>
    --start-to-end-timeout <time>
    --headless
    --trace
    --traces-path <path>
    --auth-session-instances-path <path>
    --keep-browser-open
    --cdp-url <url>
    --cdp-browser-name <name>
    --cdp-tab-id <tab_id>
    -h, --help
​
--id
string
default:"auth-session-{timestamp}"
ID of the auth session to create. The auth session files will be created in ./auth-sessions-instances/<id>. Auto-generated if not provided.
​
--check-retries
int
default:"1"
Number of attempts to check if the auth session is valid after successful creation.
​
--create-retries
int
default:"1"
Number of attempts to create the auth session.
​
--proxy
string
Proxy URL to use for the browser.
​
--timeout
string
default:"10 mins"
Timeout for each attempt. Accepts milliseconds (integer) or an ms-formatted string (e.g., 30s, 5m, 1h).
​
--start-to-end-timeout
string
default:"12 hours"
Overall timeout from start to end of the command. Accepts milliseconds or an ms-formatted string.
​
--headless
Run the browser in headless mode. By default, the browser runs in headful mode (a visible window).
​
--trace
Capture a Playwright trace of each attempt. Useful for debugging. Traces are saved to ./traces/ by default.
​
--traces-path
string
Custom directory to save trace files. Defaults to traces/.
​
--auth-session-instances-path
string
Custom directory to store/load auth session instance files. Defaults to auth-sessions-instances/.
​
--keep-browser-open
Keep the last browser open after the command completes. Useful for debugging.
​
--cdp-url
string
Chrome DevTools Protocol URL to connect to an existing browser instance. When set, --proxy, --headless, and --keep-browser-open options are ignored.
​
--cdp-browser-name
string
Name of a persistent browser instance (started with dev browser start) to connect to via CDP.
​
--cdp-tab-id
string
Browser tab ID to execute on. Requires --cdp-url or --cdp-browser-name. If not specified, the first tab is used.
​
-h, --help
Display help for command. Will not execute the command.

​
Run AuthSession Validate

Executes an AuthSession:Validate Run. Auth sessions must be enabled in Intuned.json. 
intuned dev run authsession validate <id> [options]
​
<id>
string
required
ID of the auth session to validate. The auth session files are expected to be in ./auth-sessions-instances/<id>.
Options 
    --auto-recreate
    --check-retries <number>
    --create-retries <number>
    --proxy <url>
    --timeout <time>
    --start-to-end-timeout <time>
    --headless
    --trace
    --traces-path <path>
    --auth-session-instances-path <path>
    --keep-browser-open
    --cdp-url <url>
    --cdp-browser-name <name>
    --cdp-tab-id <tab_id>
    -h, --help
​
--auto-recreate
Auto-recreate the auth session if validation fails.
​
--check-retries
int
default:"1"
Number of attempts to check if the auth session is valid.
​
--create-retries
int
default:"1"
Number of attempts to create the auth session if initial check fails.Only applicable if --auto-recreate is set.
​
--proxy
string
Proxy URL to use for the browser.
​
--timeout
string
default:"10 mins"
Timeout for each attempt. Accepts milliseconds (integer) or an ms-formatted string (e.g., 30s, 5m, 1h).
​
--start-to-end-timeout
string
default:"12 hours"
Overall timeout from start to end of the command. Accepts milliseconds or an ms-formatted string.
​
--headless
Run the browser in headless mode. By default, the browser runs in headful mode (a visible window).
​
--trace
Capture a Playwright trace of each attempt. Useful for debugging. Traces are saved to ./traces/ by default.
​
--traces-path
string
Custom directory to save trace files. Defaults to traces/.
​
--auth-session-instances-path
string
Custom directory to store/load auth session instance files. Defaults to auth-sessions-instances/.
​
--keep-browser-open
Keep the last browser open after the command completes. Useful for debugging.
​
--cdp-url
string
Chrome DevTools Protocol URL to connect to an existing browser instance. When set, --proxy, --headless, and --keep-browser-open options are ignored.
​
--cdp-browser-name
string
Name of a persistent browser instance (started with dev browser start) to connect to via CDP.
​
--cdp-tab-id
string
Browser tab ID to execute on. Requires --cdp-url or --cdp-browser-name. If not specified, the first tab is used.
​
-h, --help
Display help for command. Will not execute the command.

​
Run AuthSession Update

Executes an AuthSession:Update Run. Auth sessions must be enabled in Intuned.json. 
intuned dev run authsession update <id> [options]
​
<id>
string
required
ID of the auth session to update. The auth session files are expected to be in ./auth-sessions-instances/<id>.
Options 
    --input <parameters>
    --check-retries <number>
    --create-retries <number>
    --proxy <url>
    --timeout <time>
    --start-to-end-timeout <time>
    --headless
    --trace
    --traces-path <path>
    --auth-session-instances-path <path>
    --keep-browser-open
    --cdp-url <url>
    --cdp-browser-name <name>
    --cdp-tab-id <tab_id>
    -h, --help
​
--input
string
New JSON parameters or path to a JSON file. If not provided, the last used parameters will be used.
​
--check-retries
int
default:"1"
Number of attempts to check if the auth session is valid after successful update.
​
--create-retries
int
default:"1"
Number of attempts to create the auth session.
​
--proxy
string
Proxy URL to use for the browser.
​
--timeout
string
default:"10 mins"
Timeout for each attempt. Accepts milliseconds (integer) or an ms-formatted string (e.g., 30s, 5m, 1h).
​
--start-to-end-timeout
string
default:"12 hours"
Overall timeout from start to end of the command. Accepts milliseconds or an ms-formatted string.
​
--headless
Run the browser in headless mode. By default, the browser runs in headful mode (a visible window).
​
--trace
Capture a Playwright trace of each attempt. Useful for debugging. Traces are saved to ./traces/ by default.
​
--traces-path
string
Custom directory to save trace files. Defaults to traces/.
​
--auth-session-instances-path
string
Custom directory to store/load auth session instance files. Defaults to auth-sessions-instances/.
​
--keep-browser-open
Keep the last browser open after the command completes. Useful for debugging.
​
--cdp-url
string
Chrome DevTools Protocol URL to connect to an existing browser instance. When set, --proxy, --headless, and --keep-browser-open options are ignored.
​
--cdp-browser-name
string
Name of a persistent browser instance (started with dev browser start) to connect to via CDP.
​
--cdp-tab-id
string
Browser tab ID to execute on. Requires --cdp-url or --cdp-browser-name. If not specified, the first tab is used.
​
-h, --help
Display help for command. Will not execute the command.

​
Attempt API

Execute an API Attempt. 
intuned dev attempt api <api-name> <parameters> [options]
​
<api-name>
string
required
Name of the API to execute. APIs are under the api directory, without the file extension. Use / for nested directories.
​
<parameters>
string
required
Parameters to pass to the API. Accepts a JSON string or a path to a JSON file.
Options 
    --auth-session <id>
    -o, --output-file <path>
    --proxy <url>
    --timeout <time>
    --start-to-end-timeout <time>
    --headless
    --trace
    --traces-path <path>
    --auth-session-instances-path <path>
    --keep-browser-open
    --cdp-url <url>
    --cdp-browser-name <name>
    --cdp-tab-id <tab_id>
    -h, --help
​
--auth-session
string
Auth session ID to use for the attempt. The auth session files are expected to be in ./auth-sessions-instances/<id>.Must be provided if auth sessions are enabled in Intuned.json. Ignored if not.
​
-o, --output-file
string
Write the attempt result to a file instead of stdout. The output is a JSON object containing the result and extended payloads (if applicable).
​
--proxy
string
Proxy URL to use for the browser.
​
--timeout
string
default:"10 mins"
Timeout for each attempt. Accepts milliseconds (integer) or an ms-formatted string (e.g., 30s, 5m, 1h).
​
--start-to-end-timeout
string
default:"12 hours"
Overall timeout from start to end of the command. Accepts milliseconds or an ms-formatted string.
​
--headless
Run the browser in headless mode. By default, the browser runs in headful mode (a visible window).
​
--trace
Capture a Playwright trace of each attempt. Useful for debugging. Traces are saved to ./traces/ by default.
​
--traces-path
string
Custom directory to save trace files. Defaults to traces/.
​
--auth-session-instances-path
string
Custom directory to store/load auth session instance files. Defaults to auth-sessions-instances/.
​
--keep-browser-open
Keep the last browser open after the command completes. Useful for debugging.
​
--cdp-url
string
Chrome DevTools Protocol URL to connect to an existing browser instance. When set, --proxy, --headless, and --keep-browser-open options are ignored.
​
--cdp-browser-name
string
Name of a persistent browser instance (started with dev browser start) to connect to via CDP.
​
--cdp-tab-id
string
Browser tab ID to execute on. Requires --cdp-url or --cdp-browser-name. If not specified, the first tab is used.
​
-h, --help
Display help for command. Will not execute the command.

​
Attempt AuthSession Check

Executes an AuthSession:Check Attempt. Auth sessions must be enabled in Intuned.json. 
intuned dev attempt authsession check <id> [options]
​
<id>
string
required
ID of the auth session to check. The auth session files are expected to be in ./auth-sessions-instances/<id>.
Options 
    --proxy <url>
    --timeout <time>
    --start-to-end-timeout <time>
    --headless
    --trace
    --traces-path <path>
    --auth-session-instances-path <path>
    --keep-browser-open
    --cdp-url <url>
    --cdp-browser-name <name>
    --cdp-tab-id <tab_id>
    -h, --help
See Shared Dev Options for option details.
​
-h, --help
Display help for command. Will not execute the command.

​
Attempt AuthSession Create

Executes an AuthSession:Create Attempt. Auth sessions must be enabled in Intuned.json. 
intuned dev attempt authsession create <parameters> [options]
​
<parameters>
string
required
Parameters for auth session creation. Accepts a JSON string or a path to a JSON file.
Options 
    --id <id>
    --proxy <url>
    --timeout <time>
    --start-to-end-timeout <time>
    --headless
    --trace
    --traces-path <path>
    --auth-session-instances-path <path>
    --keep-browser-open
    --cdp-url <url>
    --cdp-browser-name <name>
    --cdp-tab-id <tab_id>
    -h, --help
​
--id
string
default:"auth-session-{timestamp}"
ID of the auth session to create. The auth session files will be created in ./auth-sessions-instances/<id>. Auto-generated if not provided.
​
--proxy
string
Proxy URL to use for the browser.
​
--timeout
string
default:"10 mins"
Timeout for each attempt. Accepts milliseconds (integer) or an ms-formatted string (e.g., 30s, 5m, 1h).
​
--start-to-end-timeout
string
default:"12 hours"
Overall timeout from start to end of the command. Accepts milliseconds or an ms-formatted string.
​
--headless
Run the browser in headless mode. By default, the browser runs in headful mode (a visible window).
​
--trace
Capture a Playwright trace of each attempt. Useful for debugging. Traces are saved to ./traces/ by default.
​
--traces-path
string
Custom directory to save trace files. Defaults to traces/.
​
--auth-session-instances-path
string
Custom directory to store/load auth session instance files. Defaults to auth-sessions-instances/.
​
--keep-browser-open
Keep the last browser open after the command completes. Useful for debugging.
​
--cdp-url
string
Chrome DevTools Protocol URL to connect to an existing browser instance. When set, --proxy, --headless, and --keep-browser-open options are ignored.
​
--cdp-browser-name
string
Name of a persistent browser instance (started with dev browser start) to connect to via CDP.
​
--cdp-tab-id
string
Browser tab ID to execute on. Requires --cdp-url or --cdp-browser-name. If not specified, the first tab is used.
​
-h, --help
Display help for command. Will not execute the command.

​
TestJob Trigger

Trigger a test job run with code from the current directory. Uploads project code and triggers execution on the Intuned platform. 
intuned dev test-job trigger [payloads] [options]
​
[payloads]
string
JSON array of payloads. Each payload object should contain apiName (required), parameters (optional), and retry (optional). Accepts a JSON string or a path to a JSON file.Not required if --from-job-config is provided.
Options 
    --from-job-config <path>
    --auth-session-input <path>
    --max-concurrent-requests <n>
    --retries <n>
    --request-timeout <n>
    --json
    -q, --quiet
    -h, --help
​
--from-job-config
string
Path to a job config file containing payload and optional configuration fields. Cannot be used together with the positional payloads argument.
​
--auth-session-input
string
Path to a JSON file with auth session input. Required if auth sessions are enabled in Intuned.json.
​
--max-concurrent-requests
int
Maximum number of concurrent requests. Only applicable when using positional payloads (not --from-job-config).
​
--retries
int
Maximum retry attempts per payload. Only applicable when using positional payloads.
​
--request-timeout
int
Request timeout in seconds. Only applicable when using positional payloads.
​
--json
default:"false"
Output as JSON.
​
-q, --quiet
default:"false"
Suppress non-essential output.
​
-h, --help
Display help for command. Will not execute the command.

​
TestJob Result

Get the result of a test job run. 
intuned dev test-job result <run-id> [options]
​
<run-id>
string
required
The run ID returned by test-job trigger.
Options 
    -w, --wait-for <duration>
    --json
    -q, --quiet
    -h, --help
​
-w, --wait-for
string
Wait for the test job to complete, polling until the given duration expires. Accepts an ms-formatted string (e.g., 30s, 5m, 2h).
​
--json
default:"false"
Output as JSON.
​
-q, --quiet
default:"false"
Suppress non-essential output.
​
-h, --help
Display help for command. Will not execute the command.

​
TestJob Download

Download test job results to a file. 
intuned dev test-job download <run-id> [options]
​
<run-id>
string
required
The run ID returned by test-job trigger.
Options 
    -o, --output-file <path>
    -w, --wait-for <duration>
    -q, --quiet
    -h, --help
​
-o, --output-file
string
Output file path. Defaults to test_results_<run-id>.json in the current directory. Can be a directory path (file will be auto-named inside it).
​
-w, --wait-for
string
Wait for the test job to complete before downloading. Accepts an ms-formatted string (e.g., 30s, 5m).
​
-q, --quiet
default:"false"
Suppress non-essential output.
​
-h, --help
Display help for command. Will not execute the command.

​
TestJob Terminate

Terminate a running test job execution. 
intuned dev test-job terminate <run-id> [options]
​
<run-id>
string
required
The run ID of the test execution to terminate.
Options 
    --json
    -q, --quiet
    -h, --help
​
--json
default:"false"
Output as JSON.
​
-q, --quiet
default:"false"
Suppress non-essential output.
​
-h, --help
Display help for command. Will not execute the command.

​
Provision

Provision project code to the Intuned platform with validation. 
intuned dev provision [options]
Options 
    -p, --project-name <name>
    --non-interactive
    --json
    -h, --help
​
-p, --project-name
string
Project name. See Project Name Resolution.
​
--non-interactive
default:"false"
Skip all prompts.
​
--json
default:"false"
Output as JSON.
​
-h, --help
Display help for command. Will not execute the command.

​
Deploy

Provision and deploy the project to the Intuned platform. This command provisions the code and then triggers a deployment. 
intuned dev deploy [options]
Options 
    -p, --project-name <name>
    --non-interactive
    --json
    -h, --help
​
-p, --project-name
string
Project name. See Project Name Resolution.
​
--non-interactive
default:"false"
Skip all prompts and auto-accept defaults.
​
--json
default:"false"
Output as JSON.
​
-h, --help
Display help for command. Will not execute the command.

​
Browser Start

Start a persistent browser instance managed by the CLI. 
intuned dev browser start [options]
Options 
    -n, --name <name>
    --cdp-port <port>
    --headless
    --viewport <WxH>
    --proxy <url>
    --json
    -h, --help
​
-n, --name
string
default:"default"
Name for the browser instance. Used to reference the browser in other commands.
​
--cdp-port
int
CDP port for the browser. If not specified, an available port is auto-selected (starting from 9222).
​
--headless
default:"false"
Run the browser in headless mode.
​
--viewport
string
default:"1280x800"
Viewport size in WIDTHxHEIGHT format (e.g., 1920x1080).
​
--proxy
string
Proxy URL to use for the browser.
​
--json
default:"false"
Output as JSON.
​
-h, --help
Display help for command. Will not execute the command.

​
Browser Stop

Stop persistent browser instance(s). 
intuned dev browser stop [options]
Options 
    -n, --name <name>
    -a, --all
    --json
    -h, --help
​
-n, --name
string
default:"default"
Name of the browser instance to stop.
​
-a, --all
default:"false"
Stop all running browser instances.
​
--json
default:"false"
Output as JSON.
​
-h, --help
Display help for command. Will not execute the command.

​
Browser Status

Show persistent browser instance status. 
intuned dev browser status [options]
Options 
    -n, --name <name>
    --json
    -h, --help
​
-n, --name
string
Browser instance name. If not specified, shows status for all instances.
​
--json
default:"false"
Output as JSON.
​
-h, --help
Display help for command. Will not execute the command.

​
Browser Tabs Create

Create a new tab in a persistent browser instance. 
intuned dev browser tabs create [options]
Options 
    -n, --name <name>
    -u, --url <url>
    --json
    -h, --help
​
-n, --name
string
default:"default"
Browser instance name.
​
-u, --url
string
default:"about:blank"
Initial URL for the new tab.
​
--json
default:"false"
Output as JSON.
​
-h, --help
Display help for command. Will not execute the command.

​
Browser Tabs List

List all tabs in a persistent browser instance. 
intuned dev browser tabs list [options]
Options 
    -n, --name <name>
    --json
    -h, --help
​
-n, --name
string
default:"default"
Browser instance name.
​
--json
default:"false"
Output as JSON.
​
-h, --help
Display help for command. Will not execute the command.

​
Browser Tabs Close

Close a tab by its ID in a persistent browser instance. 
intuned dev browser tabs close <tab-id> [options]
​
<tab-id>
string
required
Tab ID to close (4-character short ID). Use dev browser tabs list to find tab IDs.
Options 
    -n, --name <name>
    --json
    -h, --help
​
-n, --name
string
default:"default"
Browser instance name.
​
--json
default:"false"
Output as JSON.
​
-h, --help
Display help for command. Will not execute the command.

​
Reference