Platform - Intuned

The Intuned CLI provides platform commands to manage projects, runs, attempts, and jobs on the Intuned platform. These commands allow you to interact with your automations running on the platform, retrieve logs and traces, and manage job executions.

Commands

Runs
Attempts
Auth Sessions
Jobs
Job Runs
Issues
- Issues List
- Issues Get
Environment Variables
Workspace Environment Variables
Project
- Project List
- Project Get
Web Tasks

Runs List

List runs for a project.

intuned platform runs list [options]

Options

    -p, --project-name <name>
    -l, --limit <number>
    -o, --offset <number>
    -f, --filter <filter...>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

int

default:"50"

Maximum number of results to return.

int

default:"0"

Number of results to skip (for pagination).

string[]

Filter results by field. Can be specified multiple times. Supported fields: status, api_name, id, run_duration, started_at, run_type, job_id, job_run_id.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Runs Get

Get detailed information about a run.

intuned platform runs get <run-id> [options]

string

required

The ID of the run to retrieve.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Runs Start

Start a new Run.

intuned platform runs start <data> [options]

string

required

Run configuration. Accepts a JSON string or a path to a JSON file.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Attempts Get

Get detailed information about a specific Attempt.

intuned platform attempts get <run-id> [attempt-number] [options]

string

required

The ID of the Run containing the Attempt.

int

The attempt number to retrieve. If omitted, an interactive prompt is shown to select from available attempts.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Attempts Log

Download automation logs for a specific Attempt.

intuned platform attempts log <run-id> [attempt-number] [options]

string

required

The ID of the Run containing the Attempt.

int

The attempt number to download logs for. If omitted, an interactive prompt is shown.

Options

    -p, --project-name <name>
    -o, --output-file <path>
    -h, --help

string

Project name. See Project Name Resolution.

string

Output file path. Defaults to log_<run-id>_<attempt-number>.jsonl.

Display help for command. Will not execute the command.

Attempts Trace

Download a Playwright trace for a specific Attempt.

intuned platform attempts trace <run-id> [attempt-number] [options]

string

required

The ID of the Run containing the Attempt.

int

The attempt number to download the trace for. If omitted, an interactive prompt is shown.

Options

    -p, --project-name <name>
    -o, --output-file <path>
    -h, --help

string

Project name. See Project Name Resolution.

string

Output file path. Defaults to trace_<run-id>_<attempt-number>.zip.

Display help for command. Will not execute the command.

Auth Sessions List

List auth sessions for a project.

intuned platform authsessions list [options]

Options

    -p, --project-name <name>
    -l, --limit <number>
    -o, --offset <number>
    -f, --filter <filter...>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

int

default:"50"

Maximum number of results to return.

int

default:"0"

Number of results to skip (for pagination).

string[]

Filter results by field. Can be specified multiple times.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Auth Sessions Get

Get detailed information about an auth session.

intuned platform authsessions get <auth-session-id> [options]

string

required

The ID of the auth session to retrieve.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Auth Sessions Create

Create a new auth session.

intuned platform authsessions create <auth-session-id> [options]

string

required

The ID for the new auth session.

Options

    -p, --project-name <name>
    --input <json-or-file>
    --proxy <url>
    --wait [duration]
    --json
    -h, --help

string

Project name. See Project Name Resolution.

string

Credentials parameters as a JSON string or a path to a JSON file (prefixed with @).

string

Proxy URL to use for the auth session creation.

string

Wait for completion. Accepts an optional duration (e.g., 5m, 30s). Defaults to 10m if no duration is specified.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Auth Sessions Update

Update an existing auth session.

intuned platform authsessions update <auth-session-id> [options]

string

required

The ID of the auth session to update.

Options

    -p, --project-name <name>
    --input <json-or-file>
    --proxy <url>
    --wait [duration]
    --json
    -h, --help

string

Project name. See Project Name Resolution.

string

Credentials parameters as a JSON string or a path to a JSON file (prefixed with @).

string

Proxy URL to use for the auth session update.

string

Wait for completion. Accepts an optional duration (e.g., 5m, 30s). Defaults to 10m if no duration is specified.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Auth Sessions Validate

Validate an existing auth session.

intuned platform authsessions validate <auth-session-id> [options]

string

required

The ID of the auth session to validate.

Options

    -p, --project-name <name>
    --timeout <seconds>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

int

default:"300"

Timeout in seconds for the validation operation.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Auth Sessions Delete

Delete an auth session.

intuned platform authsessions delete <auth-session-id> [options]

string

required

The ID of the auth session to delete.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Jobs List

List Jobs for a project.

intuned platform jobs list [options]

Options

    -p, --project-name <name>
    -l, --limit <number>
    -o, --offset <number>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

int

default:"50"

Maximum number of results to return.

int

default:"0"

Number of results to skip (for pagination).

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Jobs Get

Get detailed information about a Job.

intuned platform jobs get <job-id> [options]

string

required

The ID of the Job to retrieve.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Jobs Create

Create a new Job.

intuned platform jobs create <data> [options]

string

required

Job configuration. Accepts a JSON string or a path to a JSON file.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Jobs Update

Update an existing Job.

intuned platform jobs update <job-id> <data> [options]

string

required

The ID of the Job to update.

string

required

Updated Job configuration. Accepts a JSON string or a path to a JSON file.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Jobs Trigger

Manually trigger a Job run.

intuned platform jobs trigger <job-id> [options]

string

required

The ID of the job to trigger.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Jobs Pause

Pause a Job. Scheduled runs stop until the Job is resumed.

intuned platform jobs pause <job-id> [options]

string

required

The ID of the Job to pause.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Jobs Resume

Resume a paused Job.

intuned platform jobs resume <job-id> [options]

string

required

The ID of the Job to resume.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Jobs Delete

Delete a Job. Asks for confirmation unless -y / --yes is passed.

intuned platform jobs delete <job-id> [options]

string

required

The ID of the Job to delete.

Options

    -p, --project-name <name>
    -y, --yes
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Skip the confirmation prompt.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

JobRuns List

List JobRuns for a specific job.

intuned platform jobruns list <job-id> [options]

string

required

The ID of the Job to list runs for.

Options

    -p, --project-name <name>
    -l, --limit <number>
    -o, --offset <number>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

int

default:"50"

Maximum number of results to return.

int

default:"0"

Number of results to skip (for pagination).

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

JobRuns Get

Get detailed information about a JobRun.

intuned platform jobruns get <job-run-id> [options]

string

required

The ID of the Job.

string

required

The ID of the JobRun to retrieve.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

JobRuns Terminate

Terminate a running JobRun. The CLI resolves the Job from the JobRun ID.

intuned platform jobruns terminate <job-run-id> [options]

string

required

The ID of the JobRun to terminate.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Issues List

List issues for a project.

intuned platform issues list [options]

Options

    -p, --project-name <name>
    -l, --limit <number>
    -o, --offset <number>
    -f, --filter <filter...>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

int

default:"50"

Maximum number of results to return.

int

default:"0"

Number of results to skip (for pagination).

string[]

Filter results by field. Can be specified multiple times.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Issues Get

Get detailed information about an issue.

intuned platform issues get <issue-ref> [options]

int

required

The issue reference number.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Env Vars List

List environment variables for a project.

intuned platform env-vars list [options]

Options

    -p, --project-name <name>
    -l, --limit <number>
    -o, --offset <number>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

int

default:"50"

Maximum number of results to return.

int

default:"0"

Number of results to skip (for pagination).

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Env Vars Get

Get details of an environment variable by key.

intuned platform env-vars get <key> [options]

string

required

The environment variable key.

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Env Vars Create

Create a new environment variable.

intuned platform env-vars create [options]

Options

    -p, --project-name <name>
    --key <key>
    --value <value>
    --description <description>
    --envs <envs>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

string

required

Variable key. Must be 1–100 characters, alphanumeric or underscore, and cannot start with a digit.

string

required

Variable value. Must be 1–1000 characters.

string

Variable description. Up to 1000 characters.

string

default:"PUBLISHED"

Comma-separated environments. Supported values: AUTHORING, PUBLISHED.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Env Vars Update

Update an existing environment variable by key.

intuned platform env-vars update <current-key> [options]

string

required

The current key of the environment variable to update.

Options

    -p, --project-name <name>
    --key <key>
    --value <value>
    --description <description>
    --envs <envs>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

string

Updated variable key. Must be 1–100 characters, alphanumeric or underscore, and cannot start with a digit.

string

Updated variable value. Must be 1–1000 characters.

string

Updated variable description. Up to 1000 characters.

string

Updated comma-separated environments. Supported values: AUTHORING, PUBLISHED.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Env Vars Delete

Delete an environment variable by key.

intuned platform env-vars delete <key> [options]

string

required

The environment variable key to delete.

Options

    -p, --project-name <name>
    --force
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Skip the confirmation prompt.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Workspace Env Vars List

List workspace-level environment variables.

intuned platform workspace env-vars list [options]

Options

    -l, --limit <number>
    -o, --offset <number>
    --json
    -h, --help

int

default:"50"

Maximum number of results to return.

int

default:"0"

Number of results to skip (for pagination).

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Workspace Env Vars Get

Get details of a workspace environment variable by key.

intuned platform workspace env-vars get <key> [options]

string

required

The environment variable key.

Options

    --json
    -h, --help

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Workspace Env Vars Create

Create a new workspace-level environment variable.

intuned platform workspace env-vars create [options]

Options

    --key <key>
    --value <value>
    --description <description>
    --envs <envs>
    --json
    -h, --help

string

required

Variable key. Must be 1–100 characters, alphanumeric or underscore, and cannot start with a digit.

string

required

Variable value. Must be 1–1000 characters.

string

Variable description. Up to 1000 characters.

string

default:"PUBLISHED"

Comma-separated environments. Supported values: AUTHORING, PUBLISHED.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Workspace Env Vars Update

Update an existing workspace environment variable by key.

intuned platform workspace env-vars update <current-key> [options]

string

required

The current key of the environment variable to update.

Options

    --key <key>
    --value <value>
    --description <description>
    --envs <envs>
    --json
    -h, --help

string

Updated variable key. Must be 1–100 characters, alphanumeric or underscore, and cannot start with a digit.

string

Updated variable value. Must be 1–1000 characters.

string

Updated variable description. Up to 1000 characters.

string

Updated comma-separated environments. Supported values: AUTHORING, PUBLISHED.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Workspace Env Vars Delete

Delete a workspace environment variable by key.

intuned platform workspace env-vars delete <key> [options]

string

required

The environment variable key to delete.

Options

    --force
    --json
    -h, --help

default:"false"

Skip the confirmation prompt.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Project List

List all projects in the workspace.

intuned platform project list [options]

Options

    -l, --limit <number>
    -o, --offset <number>
    --ai-enabled
    --json
    -h, --help

int

default:"50"

Maximum number of results to return.

int

default:"0"

Number of results to skip (for pagination).

default:"false"

Only show projects with AI enabled.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Project Get

Get detailed information about the current project.

intuned platform project get [options]

Options

    -p, --project-name <name>
    --json
    -h, --help

string

Project name. See Project Name Resolution.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Web Tasks Start

Start a new Web Task. Returns the webTaskId immediately; use webtasks result to fetch the result.

intuned platform webtasks start <task> [options]

string

required

Natural-language description of the task to run.

Options

    --start-url <url>
    --parameters <json-or-file>
    --output-schema <json-or-file>
    --reuse-key <key>
    --model <model>
    --json
    -h, --help

string

Optional hint telling the agent where to start in the browser.

string

Free-form parameters as a JSON string or a path to a JSON file.

string

Expected output JSON Schema as a JSON string or a path to a JSON file.

string

Reuse key for persisted task resources. If omitted, the server generates one and returns it in the result.

string

default:"haiku"

Model to use: haiku, sonnet, or opus.

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Web Tasks Run

Start a Web Task and block until it reaches a terminal state (completed or canceled).

intuned platform webtasks run <task> [options]

string

required

Natural-language description of the task to run.

Options

    --start-url <url>
    --parameters <json-or-file>
    --output-schema <json-or-file>
    --reuse-key <key>
    --model <model>
    --wait [duration]
    --json
    -h, --help

string

Optional hint telling the agent where to start in the browser.

string

Free-form parameters as a JSON string or a path to a JSON file.

string

Expected output JSON Schema as a JSON string or a path to a JSON file.

string

Reuse key for persisted task resources. If omitted, the server generates one and returns it in the result.

string

default:"haiku"

Model to use: haiku, sonnet, or opus.

string

default:"10m"

Stop waiting after the given duration (for example, 30s, 10m, 2h).

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Web Tasks Result

Fetch the current status and result of a Web Task.

intuned platform webtasks result <web-task-id> [options]

string

required

The ID returned when the task was started.

Options

    --json
    -h, --help

default:"false"

Output as JSON.

Display help for command. Will not execute the command.

Project Name Resolution

Commands that operate on a project resolve the project name in this order: --project-name flag > projectName field in settings file > Error

Reference

Overview
Dev reference — Develop and test automations locally.
Configuration — Settings file, environment variables, and authentication.

​Commands

​Runs List

​Runs Get

​Runs Start

​Attempts Get

​Attempts Log

​Attempts Trace

​Auth Sessions List

​Auth Sessions Get

​Auth Sessions Create

​Auth Sessions Update

​Auth Sessions Validate

​Auth Sessions Delete

​Jobs List

​Jobs Get

​Jobs Create

​Jobs Update

​Jobs Trigger

​Jobs Pause

​Jobs Resume

​Jobs Delete

​JobRuns List

​JobRuns Get

​JobRuns Terminate

​Issues List

​Issues Get

​Env Vars List

​Env Vars Get

​Env Vars Create

​Env Vars Update

​Env Vars Delete

​Workspace Env Vars List

​Workspace Env Vars Get

​Workspace Env Vars Create

​Workspace Env Vars Update

​Workspace Env Vars Delete

​Project List

​Project Get

​Web Tasks Start

​Web Tasks Run

​Web Tasks Result

​Project Name Resolution

​Reference

Commands

Runs List

Runs Get

Runs Start

Attempts Get

Attempts Log

Attempts Trace

Auth Sessions List

Auth Sessions Get

Auth Sessions Create

Auth Sessions Update

Auth Sessions Validate

Auth Sessions Delete

Jobs List

Jobs Get

Jobs Create

Jobs Update

Jobs Trigger

Jobs Pause

Jobs Resume

Jobs Delete

JobRuns List

JobRuns Get

JobRuns Terminate

Issues List

Issues Get

Env Vars List

Env Vars Get

Env Vars Create

Env Vars Update

Env Vars Delete

Workspace Env Vars List

Workspace Env Vars Get

Workspace Env Vars Create

Workspace Env Vars Update

Workspace Env Vars Delete

Project List

Project Get

Web Tasks Start

Web Tasks Run

Web Tasks Result

Project Name Resolution

Reference