Commands
- Init
- List Templates
- Run
- Attempt
- Test Job
- Provision
- Deploy
- Browser
- Stealth
- Captcha Solve
- Proxy
Init
Initialize a new Intuned project from a template or GitHub URL.string
Directory to initialize the project in. Defaults to the current directory.
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.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.
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.
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>.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>.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.
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>.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.
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.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.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.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.
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.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.
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.
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.
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.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).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.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.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.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.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.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.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.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.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.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.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
- Overview
- Platform reference — Manage projects on Intuned platform.
- Configuration — Settings file, environment variables, and authentication.