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

Commands


Init

Initialize a new Intuned project from a template or GitHub URL.
string
Directory to initialize the project in. Defaults to the current directory.
Options
string
Template ID to use for project initialization. Use dev list-templates to see available templates.
string
Project language. Supported values: typescript, python.
string
Clone from a GitHub URL instead of using a template.
default:"false"
Overwrite existing files instead of erroring on conflicts.
default:"false"
Run without interactive prompts.
default:"false"
Enable stealth mode in the project settings.
default:"false"
Enable captcha solver in the project settings.
string
Set the dev proxy in the project settings. Pass alone to opt into intuned://auto (Intuned’s managed proxy) when no default proxy is already set, or pass an explicit URL.
default:"false"
Also set the deployed environment proxy to the same URL. Requires --proxy.
default:"false"
Install dependencies after project creation.
string
Format of the settings file. Supported values: json, jsonc, yaml, toml. If not specified, auto-detected from the existing file or defaults to jsonc.
Display help for command. Will not execute the command.

List Templates

List available project templates.
Options
string
Filter templates by language. Supported values: typescript, python.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Run API

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

Attempt API

Execute an API Attempt.
string
required
Name of the API to execute. APIs are under the api directory, without the file extension. Use / for nested directories.
string
required
Parameters to pass to the API. Accepts a JSON string or a path to a JSON file.
Options
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.
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).
string
Proxy URL to use for the browser.
string
IANA timezone to apply to the browser (for example America/New_York). See Proxy with timezone.
string
default:"10 mins"
Timeout for each attempt. Accepts milliseconds (integer) or an ms-formatted string (e.g., 30s, 5m, 1h).
string
default:"12 hours"
Overall timeout from start to end of the command. Accepts milliseconds or an ms-formatted string.
Run the browser in headless mode. By default, the browser runs in headful mode (a visible window).
Capture a Playwright trace of each attempt. Useful for debugging. Traces are saved to ./traces/ by default.
string
Custom directory to save trace files. Defaults to traces/.
string
Custom directory to store/load auth session instance files. Defaults to auth-sessions-instances/.
Keep the last browser open after the command completes. Useful for debugging.
string
Chrome DevTools Protocol URL to connect to an existing browser instance. When set, --proxy, --headless, and --keep-browser-open options are ignored.
string
Name of a persistent browser instance (started with dev browser start) to connect to via CDP.
string
Browser tab ID to execute on. Requires --cdp-url or --cdp-browser-name. If not specified, the first tab is used.
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.
string
required
ID of the auth session to check. The auth session files are expected to be in ./auth-sessions-instances/<id>.
Options
See Shared Dev Options for option details.
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.
string
required
Parameters for auth session creation. Accepts a JSON string or a path to a JSON file.
Options
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.
string
Proxy URL to use for the browser.
string
IANA timezone to apply to the browser (for example America/New_York). See Proxy with timezone.
string
default:"10 mins"
Timeout for each attempt. Accepts milliseconds (integer) or an ms-formatted string (e.g., 30s, 5m, 1h).
string
default:"12 hours"
Overall timeout from start to end of the command. Accepts milliseconds or an ms-formatted string.
Run the browser in headless mode. By default, the browser runs in headful mode (a visible window).
Capture a Playwright trace of each attempt. Useful for debugging. Traces are saved to ./traces/ by default.
string
Custom directory to save trace files. Defaults to traces/.
string
Custom directory to store/load auth session instance files. Defaults to auth-sessions-instances/.
Keep the last browser open after the command completes. Useful for debugging.
string
Chrome DevTools Protocol URL to connect to an existing browser instance. When set, --proxy, --headless, and --keep-browser-open options are ignored.
string
Name of a persistent browser instance (started with dev browser start) to connect to via CDP.
string
Browser tab ID to execute on. Requires --cdp-url or --cdp-browser-name. If not specified, the first tab is used.
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.
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
string
Path to a job config file containing payload and optional configuration fields. Cannot be used together with the positional payloads argument.
string
Path to a JSON file with auth session input. Required if auth sessions are enabled in Intuned.json.
int
Maximum number of concurrent requests. Only applicable when using positional payloads (not --from-job-config).
int
Maximum retry attempts per payload. Only applicable when using positional payloads.
int
Request timeout in seconds. Only applicable when using positional payloads.
default:"false"
Output as JSON.
default:"false"
Suppress non-essential output.
Display help for command. Will not execute the command.

TestJob Result

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

TestJob Download

Download test job results to a file.
string
required
The run ID returned by test-job trigger.
Options
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).
string
Wait for the test job to complete before downloading. Accepts an ms-formatted string (e.g., 30s, 5m).
default:"false"
Suppress non-essential output.
Display help for command. Will not execute the command.

TestJob Terminate

Terminate a running test job execution.
string
required
The run ID of the test execution to terminate.
Options
default:"false"
Output as JSON.
default:"false"
Suppress non-essential output.
Display help for command. Will not execute the command.

Project name resolution

Checkout, provision, save, and deploy use --project-name when provided. Otherwise, they use projectName from the Intuned settings file. The command fails if neither value is available.

Checkout

Check out an existing Intuned project into a local directory. The CLI preserves local-only files. If an incoming file differs from a local file, the command asks before replacing it.
Options
string
default:"."
Directory where the project is checked out.
string
Project name. See Project Name Resolution.
default:"false"
Replace local files that differ from the project on Intuned.
default:"false"
Disable prompts. The command aborts on conflicting files unless you also pass --override.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Provision

Create an empty connected project on Intuned. The command updates the local project settings, .env, and .intuned/checkout, then offers to save the local files. It fails if the project already exists and recommends intuned dev save instead.
Options
string
Project name. See Project Name Resolution.
default:"false"
Disable prompts. The project is created without saving local files.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Save

Provision the project if it does not exist, then save local project files to Intuned. For an existing project, Intuned uses a three-way merge when valid checkout information is available and reports conflicts before changing the project. A successful save refreshes the synchronization information in .intuned/checkout.
Options
string
Project name. See Project Name Resolution.
default:"false"
Use local files for conflicts. If checkout information is missing, overwrite the remote project with the local project tree.
default:"false"
Disable prompts. The command aborts when confirmation is required unless you also pass --override.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Deploy

Save and deploy the project to Intuned. The deployment starts only after the save succeeds, unless you pass --no-save.
Options
string
Project name. See Project Name Resolution.
default:"false"
Skip saving local changes before deployment.
default:"false"
Pass --override to the save step.
default:"false"
Disable prompts. The save step aborts when confirmation is required unless you also pass --override.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Browser Start

Start a persistent browser instance managed by the CLI.
Options
string
default:"default"
Name for the browser instance. Used to reference the browser in other commands.
int
CDP port for the browser. If not specified, an available port is auto-selected (starting from 9222).
default:"false"
Run the browser in headless mode.
string
default:"1280x800"
Viewport size in WIDTHxHEIGHT format (e.g., 1920x1080).
string
Proxy URL to use for the browser. Falls back to defaults.proxy.dev from the Intuned settings file when omitted.
string
IANA timezone to apply to the browser (for example America/New_York). Falls back to the timezone on defaults.proxy.dev when omitted. See Proxy with timezone.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Browser Stop

Stop persistent browser instance(s).
Options
string
default:"default"
Name of the browser instance to stop.
default:"false"
Stop all running browser instances.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Browser Status

Show persistent browser instance status.
Options
string
Browser instance name. If not specified, shows status for all instances.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Browser Tabs Create

Create a new tab in a persistent browser instance.
Options
string
default:"default"
Browser instance name.
string
default:"about:blank"
Initial URL for the new tab.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Browser Tabs List

List all tabs in a persistent browser instance.
Options
string
default:"default"
Browser instance name.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Browser Tabs Close

Close a tab by its ID in a persistent browser instance.
string
required
Tab ID to close (4-character short ID). Use dev browser tabs list to find tab IDs.
Options
string
default:"default"
Browser instance name.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Stealth Enable

Enable stealth mode, restarting the browser with stealth mode on if it is running.
Options
string
default:"default"
Browser instance name.
string
Format of the settings file. Supported values: json, jsonc, yaml, toml. If not specified, auto-detected from the existing file or defaults to jsonc.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Stealth Disable

Disable stealth mode, restarting the browser if it is running.
Options
string
default:"default"
Browser instance name.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Captcha Solve Enable

Enable the captcha solver extension, restarting the browser if it is running.
Options
string
default:"default"
Browser instance name.
string
Format of the settings file. Supported values: json, jsonc, yaml, toml. If not specified, auto-detected from the existing file or defaults to jsonc.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Captcha Solve Disable

Disable the captcha solver extension, restarting the browser if it is running.
Options
string
default:"default"
Browser instance name.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Proxy Set

Set the dev proxy, restarting the browser if it is running. Optionally pair the proxy with a browser timezone (written to the Intuned settings file as { url, timezone }).
string
default:"intuned://auto"
Proxy URL to set. Defaults to intuned://auto, Intuned’s managed proxy.
Options
string
default:"default"
Browser instance name.
default:"false"
Do not restart the browser after setting the proxy.
default:"false"
Also set the deployed proxy in addition to the dev proxy.
string
IANA timezone to set alongside the proxy (for example America/New_York). Stored on defaults.proxy in the Intuned settings file. See Proxy with timezone.
string
Format of the settings file. Supported values: json, jsonc, yaml, toml. If not specified, auto-detected from the existing file or defaults to jsonc.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Proxy Clear

Clear the dev and deployed proxy, restarting the browser if it is running.
Options
string
default:"default"
Browser instance name.
default:"false"
Do not restart the browser after clearing the proxy.
default:"false"
Output as JSON.
Display help for command. Will not execute the command.

Reference