# @copado/agentia-cli

Command-line interface for Agentia headless Copado workflows (auth, environments, jobs, pipelines, metadata, and local MCP).

[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
[![Version](https://img.shields.io/npm/v/%40copado%2Fagentia-cli.svg)](https://www.npmjs.com/package/@copado/agentia-cli)
[![Downloads/week](https://img.shields.io/npm/dw/%40copado%2Fagentia-cli.svg)](https://www.npmjs.com/package/@copado/agentia-cli)

<!-- toc -->
* [@copado/agentia-cli](#copadoagentia-cli)
* [Usage](#usage)
* [Local MCP Server](#local-mcp-server)
* [Local Quality Gates](#local-quality-gates)
* [License](#license)
* [Commands](#commands)
<!-- tocstop -->

# Usage

<!-- usage -->
```sh-session
$ npm install -g @copado/agentia-cli@latest --registry https://registry.npmjs.org --@copado:registry=https://registry.npmjs.org
$ agentia COMMAND
running command...
$ agentia (--version)
@copado/agentia-cli/1.2.0 linux-x64 node-v22.23.4
$ agentia --help [COMMAND]
USAGE
  $ agentia COMMAND
...
```
<!-- usagestop -->

Agentia checks npm `rc` and `latest` in the background and warns when a newer release is available for the installed version. Auto-selection uses an optional `updateChannel` preference in `~/.config/agentia-cli/config.json` (`rc` keeps dual-channel compare and still installs a SemVer-greater stable; `latest` is stable-only). With no preference, prerelease installs compare both tags and pick the highest newer SemVer, while stable installs compare only `latest`. Run `agentia update` to install the selected release (an interactive RC-to-stable crossing can prompt once to save a preference; after a successful install it warns to run `setup skills update` in each project that uses Agentia-managed skills), `agentia update --check` to check without changing the installation or preference, or `agentia update --channel rc|latest` to force a channel and save that preference on install. RC is the supported prerelease channel; stable publications use npm's `latest` dist-tag.

Store gateway credentials before calling gateway-backed commands:

```sh-session
$ agentia auth set --cicd <api-key> --region na
$ agentia auth get
```

## Using Agentia behind a proxy

Agentia honors the standard proxy environment variables on every outbound HTTP(S) request and on CRT live WebSocket connections, similar to Salesforce CLI:

- `HTTPS_PROXY` / `https_proxy` for TLS traffic (recommended)
- `HTTP_PROXY` / `http_proxy` for plain HTTP
- `NO_PROXY` / `no_proxy` for hosts that must connect directly (comma-separated; supports `*` suffix wildcards)
- npm-style `npm_config_https_proxy`, `npm_config_proxy`, and `npm_config_no_proxy` when the CLI runs under npm

Loopback targets (`localhost`, `127.0.0.1`, `::1`) always bypass the proxy so local gateway development and IDE listeners stay direct.

```sh-session
$ export HTTPS_PROXY=http://proxy.example.com:3128
$ export NO_PROXY=localhost,127.0.0.1,.mycompany.com
$ agentia cicd project list
```

Corporate TLS inspection may require trusting your organization CA. Set `NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem`, or use `NODE_USE_SYSTEM_CA=1` on supported Node versions.

For Cursor or Claude Code MCP, pass the same variables in the MCP server `env` block so gateway tools inherit them.

NTLM or Kerberos proxy authentication is not built in; use a local forwarding proxy such as `px` or `cntlm` that presents a plain HTTP proxy to Agentia.

## Read a user story

`agentia cicd work get <id> --json` returns the complete user-story record supplied by the CICD gateway in the `result` property. The JSON response preserves nested related `epic` and `feature` records; human output presents the same field groups while redacting `oauthSignature`. Pass `--user-stories-ahead-behind` to also compare how many user stories are ahead of and behind the next pipeline environment when the story has a pipeline and source environment.

```sh-session
$ agentia cicd work get US-0001 --json
$ agentia cicd work get US-0001 --user-stories-ahead-behind
```

```json
{
  "result": {
    "id": "a1Y000000000001EAA",
    "name": "US-0001",
    "title": "Improve deployment validation",
    "status": "Development In Progress",
    "project": "a0w000000000001AAA",
    "projectName": "Example Project",
    "pipelineId": "a0M000000000001EAA",
    "sourceEnvironment": "a0S000000000001EAA",
    "baseBranch": "main",
    "epic": {"id": "a0E000000000001EAA", "name": "EPIC-1", "title": "Example epic"},
    "feature": {"id": "aDs000000000001EAA", "title": "Example feature"}
  },
  "status": 0,
  "transactionId": "..."
}
```

`cicd work create` and `cicd work update` validate `--acceptance-criteria` locally: it must contain fewer than 255 characters.

For Copado AI agents, store the AI PAT and organization context once, then use `ask` for scripts or `chat` for an interactive session:

```sh-session
$ agentia auth set --ai <pat-token> --ai-domain robotic.copado.com --ai-org 42888
$ agentia ai agent ask --agent plan -p "Break this requirement into implementation steps"
$ agentia ai agent ask --agent knowledge -p "Summarize the available workspace guidance"
$ agentia ai agent chat --agent build --sf-org test14 --user-story US-1042
```

## Agent Skills Setup

`agentia setup skills create` installs portable Markdown-only Agent Skills that teach compatible agents how to use Agentia CICD (including metadata exploration), CRT Testing, AI, and Pipelines Advanced commands correctly, plus target-specific routing artifacts (`.agents/skills/agentia/SKILL.md`, `.cursor/rules/agentia.mdc`, or `.claude/skills/agentia/SKILL.md`). Use `--target agents` for `.agents/skills` (portable default), `--target cursor` for `.cursor/skills`, or `--target claude` for `.claude/skills`. Setup does not modify customer root `AGENTS.md`.

```sh-session
$ agentia setup skills create --target agents
$ agentia setup skills create --cicd --target cursor --no-prompt
$ agentia setup skills update --ai --target agents --no-prompt
```

Use `update` to refresh Agentia-managed skill files. Unrelated files are preserved, and existing files without the Agentia managed marker are not overwritten unless `--force` is explicit.

### Plugin skills

An installed plugin can contribute skills through an `agentia:contribute` hook (see [plugin-sdk/README.md](plugin-sdk/README.md)). They are third-party prompts, so none are installed by default and the hook runs only when you ask for plugin skills: interactive `setup skills create`, `--plugin`, `setup skills list`, or `setup skills update` when plugin skills are already installed. Interactive `setup skills create` lists what plugins contribute (nothing ticked) and installs only the ones you select; headless runs and `--json` install them only with `--plugin`:

```sh-session
$ agentia setup skills list
$ agentia setup skills create            # pick plugin skills in the prompt
$ agentia setup skills create --plugin @acme/agentia-plugin-release --target cursor --no-prompt
$ agentia setup skills update
```

A contributed skill with id `release` installs as `agentia-release`. `setup skills list` shows installable skills and why an invalid one is skipped; one failing or slow plugin never blocks the others, and a plugin without the hook is ignored. With `--plugin` and no pack flag only plugin skills are written; otherwise the generated Agentia rules file gets a "Plugin skills" line for each installed plugin skill. Plugin skills carry a per-plugin managed marker; files that are unmanaged or owned by another plugin are never replaced without `--force`. `setup skills update` with no flags also refreshes plugin skills already in the project, and warns when their plugin is uninstalled or no longer contributes them. Nothing is deleted unless you run `agentia setup skills update --prune`, which removes only the files that carry that plugin's managed marker (never unmarked files, symlinks, or other plugins' files), drops their line from the rules file, and is skipped for any plugin whose hook failed or timed out. Contributions are rejected if they list non-Markdown files, symbolic links, paths outside the plugin, `allowed-tools`, a reserved or duplicate id, an unsupported `apiVersion`, or exceed 50 files, 256 KiB per file, or 1 MiB per skill.

Contributor setup, local gateway mode, and integration testing are documented in [DEVELOPMENT.md](DEVELOPMENT.md).

# Local MCP Server

Agentia can run as a local Model Context Protocol (MCP) server over stdio. MCP-compatible clients such as Cursor can then call Agentia tools without using the terminal.

## Prerequisites

1. Install the CLI so `agentia` is available:

```sh-session
$ npm install -g @copado/agentia-cli@rc --registry https://registry.npmjs.org --@copado:registry=https://registry.npmjs.org
```

2. Store credentials. The MCP server reuses the same keychain-backed auth as the CLI:

```sh-session
$ agentia auth set --cicd <api-key> --region na
$ agentia auth set --ai <pat-token> --ai-domain robotic.copado.com --ai-org 42888
$ agentia auth get
```

3. Confirm the MCP command is available:

```sh-session
$ agentia mcp --help
$ agentia mcp start --help
```

## Start the server

```sh-session
$ agentia mcp start
```

This command is long-running. It speaks MCP over stdio and waits for a client connection. Do not expect interactive terminal output after start.

## Configure Cursor

Add an MCP server entry that launches Agentia:

```json
{
  "mcpServers": {
    "agentia": {
      "type": "stdio",
      "command": "agentia",
      "args": ["mcp", "start"],
      "env": {
        "AGENTIA_PROJECT_ROOT": "${workspaceFolder}"
      }
    }
  }
}
```

This works in either `.cursor/mcp.json` or global `~/.cursor/mcp.json`: Cursor expands `${workspaceFolder}` for the active workspace, so Agentia loads that repository's `.agentia` defaults, project auth, and `.env`. After saving the config, reload MCP servers in Cursor.

## Configure Claude Code

`agentia setup` can write the project `.mcp.json` entry for Claude Code and pre-approve the `agentia` server in `.claude/settings.local.json`. The recommended entry passes Claude's project directory through to Agentia:

```json
{
  "mcpServers": {
    "agentia": {
      "type": "stdio",
      "command": "agentia",
      "args": ["mcp", "start"],
      "env": {
        "AGENTIA_PROJECT_ROOT": "${CLAUDE_PROJECT_DIR:-}"
      }
    }
  }
}
```

Claude Code expands `CLAUDE_PROJECT_DIR` for local stdio servers. If `AGENTIA_PROJECT_ROOT` or `CLAUDE_PROJECT_DIR` is empty or still an unexpanded placeholder (for example `${CLAUDE_PROJECT_DIR:-}`), Agentia ignores it and falls back to the MCP client's reported folder, then walks upward for project markers.

You can also add Agentia manually with `claude mcp add` or an `mcpServers` entry in `~/.claude.json`.

For other local MCP clients, set `AGENTIA_PROJECT_ROOT` to an absolute project directory. When no explicit root exists, Agentia uses one local MCP root when available, otherwise searches upward from its startup directory. Multiple local roots require `AGENTIA_PROJECT_ROOT` to avoid selecting the wrong project.

Optional definitive override: set `AGENTIA_MCP_PROJECT_ROOT` to an absolute project directory in the MCP server `env`. When set, Agentia uses that path as the project root for defaults, auth profiles, and `.env` loading, and does not use the client's `roots/list` result for project selection.

## Request identity

Gateway requests identify **what** ran in `Referer` and **how** it ran in `User-Agent` and `event-source`.

- Shell CLI: `Referer` is the oclif command id (for example `cicd:environment:list`). `User-Agent` is `agentia-cli/<version>` and `event-source` is `agentia-cli`.
- MCP: tools that wrap a CLI command send that same command id as `Referer`. `User-Agent` is `agentia-mcp/<version>` and `event-source` is `agentia-mcp`. MCP-only helpers keep their MCP tool id as `Referer`.
- IDE: set `AGENTIA_CLIENT_ORIGIN=ide` when the IDE extension spawns Agentia, including `agentia mcp start`, and pass the extension version as `AGENTIA_IDE_VERSION`. A valid IDE version produces `User-Agent: agentia-ide/<ide-version> (agentia-cli/<cli-version>)`; missing or invalid values fall back to `agentia-ide/<cli-version>`. `event-source` remains `agentia-ide`. Unsupported origin values and IDE versions are ignored.

## Available tools

Tools are JSON-safe and return structured results. Sensitive fields are redacted.

| Topic | Tools |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AI | `agentia_ai_ask` |
| Auth | `agentia_auth_get`, `agentia_auth_set` |
| ADV | `agentia_adv_auth_status`, `agentia_adv_organization_list`, `agentia_adv_organization_get`, `agentia_adv_organization_validate`, `agentia_adv_deployment_list`, `agentia_adv_deployment_get`, `agentia_adv_deployment_create`, `agentia_adv_deployment_options`, `agentia_adv_deployment_validate`, `agentia_adv_deployment_deploy`, `agentia_adv_deployment_quick_deploy`, `agentia_adv_deployment_cancel`, `agentia_adv_component_types`, `agentia_adv_component_list`, `agentia_adv_component_refresh`, `agentia_adv_component_selected`, `agentia_adv_component_add`, `agentia_adv_component_remove`, `agentia_adv_job_get`, `agentia_adv_job_list`, `agentia_adv_job_wait` |
| Credential | `agentia_credential_list`, `agentia_credential_create`, `agentia_credential_update`, `agentia_credential_auth_status` |
| Data | `agentia_data_template_list`, `agentia_data_template_get`, `agentia_data_template_get_detail`, `agentia_data_template_create`, `agentia_data_template_save_detail`, `agentia_data_template_delete`, `agentia_data_template_convert_old`, `agentia_data_records_search`, `agentia_data_records_match`, `agentia_data_commit_create`, `agentia_data_commit_list`, `agentia_data_dataset_file_list`, `agentia_data_dataset_file_content`, `agentia_data_filter_list`, `agentia_data_filter_add`, `agentia_data_filter_update`, `agentia_data_filter_delete`, `agentia_data_formula_list`, `agentia_data_formula_create`, `agentia_data_formula_update`, `agentia_data_sobject_fields`, `agentia_data_sobject_relationships`, `agentia_data_sync_apply`, `agentia_data_sync_preview_updates` |
| Environment | `agentia_environment_list`, `agentia_environment_get`, `agentia_environment_create`, `agentia_environment_update`, `agentia_environment_auth_status` |
| Function | `agentia_function_list`, `agentia_function_get`, `agentia_function_defaults`, `agentia_function_upsert`, `agentia_function_delete`, `agentia_function_run`, `agentia_function_run_local`, `agentia_function_result_get`, `agentia_function_result_log_get` |
| Job Template | `agentia_template_list`, `agentia_template_get`, `agentia_template_defaults`, `agentia_template_upsert`, `agentia_template_delete` |
| Governance | `agentia_health_check` |
| Job | `agentia_job_list`, `agentia_job_get`, `agentia_job_log_get`, `agentia_job_run`, `agentia_job_resume`, `agentia_job_kill`, `agentia_job_pause` |
| Pipeline | `agentia_pipeline_list`, `agentia_pipeline_get`, `agentia_pipeline_create`, `agentia_pipeline_update`, `agentia_pipeline_connection_list`, `agentia_pipeline_connection_create`, `agentia_pipeline_connection_update`, `agentia_pipeline_connection_delete`, `agentia_pipeline_stage_connection_list`, `agentia_pipeline_stage_connection_create`, `agentia_pipeline_stage_connection_update`, `agentia_pipeline_stage_connection_delete`, `agentia_pipeline_automation_list`, `agentia_pipeline_automation_get`, `agentia_pipeline_automation_create`, `agentia_pipeline_automation_update`, `agentia_pipeline_automation_delete`, `agentia_pipeline_automation_activate`, `agentia_pipeline_automation_deactivate`, `agentia_pipeline_quality_gate_list`, `agentia_pipeline_quality_gate_get`, `agentia_pipeline_quality_gate_create`, `agentia_pipeline_quality_gate_update`, `agentia_pipeline_quality_gate_delete`, `agentia_pipeline_quality_gate_activate`, `agentia_pipeline_quality_gate_deactivate`, `agentia_extension_configuration_list`, `agentia_extension_configuration_get` |
| Stage | `agentia_stage_list`, `agentia_stage_get`, `agentia_stage_create`, `agentia_stage_update`, `agentia_stage_delete` |
| Project | `agentia_project_list`, `agentia_project_get`, `agentia_project_create`, `agentia_project_update`, `agentia_project_delete`, `agentia_project_default_get`, `agentia_project_default_set`, `agentia_project_default_unset` |
| Repository | `agentia_repository_list`, `agentia_repository_get`, `agentia_repository_create`, `agentia_repository_update`, `agentia_repository_delete`, `agentia_repository_reset`, `agentia_repository_validate` |
| Promotion | `agentia_promotion_list`, `agentia_promotion_get`, `agentia_promotion_run`, `agentia_promotion_job_step_update`, `agentia_promotion_conflict_list`, `agentia_promotion_conflict_get`, `agentia_promotion_conflict_resolve`, `agentia_promotion_conflict_unresolve` |
| User | `agentia_user_get` |
| Work | `agentia_work_list`, `agentia_work_get`, `agentia_work_create`, `agentia_work_update`, `agentia_work_delete`, `agentia_work_deployment_step_types`, `agentia_work_deployment_step_salesforce_flows`, `agentia_work_deployment_step_list`, `agentia_work_deployment_step_create`, `agentia_work_deployment_step_update`, `agentia_work_deployment_step_reorder`, `agentia_work_deployment_step_delete`, `agentia_work_set`, `agentia_work_status`, `agentia_work_publish`, `agentia_work_push`, `agentia_work_test`, `agentia_work_test_apex`, `agentia_work_submit`, `agentia_work_done` |
| Cloud | `agentia_cloud_commit`, `agentia_cloud_promote` (`agentia_work_commit` remains a compatibility alias of `agentia_cloud_commit`) |
| Metadata | `agentia_metadata_list`, `agentia_metadata_explore`, `agentia_metadata_content_get`, `agentia_metadata_content_compare`, `agentia_metadata_index_compare`, `agentia_metadata_dependency_list`, `agentia_metadata_refresh_run`, `agentia_metadata_refresh_status`, `agentia_metadata_refresh_deleted` |
| Notification | `agentia_notification_configure`, `agentia_notification_get` |
| Testing | `agentia_testing_project_list`, `agentia_testing_project_get`, `agentia_testing_project_create`, `agentia_testing_project_delete`, `agentia_testing_robot_list`, `agentia_testing_robot_get`, `agentia_testing_robot_create`, `agentia_testing_robot_delete`, `agentia_testing_job_list`, `agentia_testing_job_get`, `agentia_testing_job_create`, `agentia_testing_job_run`, `agentia_testing_job_update`, `agentia_testing_job_delete`, `agentia_testing_job_files_list`, `agentia_testing_job_files_upload`, `agentia_testing_job_files_download`, `agentia_testing_job_runs_list`, `agentia_testing_job_runs_get`, `agentia_testing_job_runs_search`, `agentia_testing_job_runs_logs`, `agentia_testing_job_runs_abort`, `agentia_testing_variable_list`, `agentia_testing_variable_create`, `agentia_testing_variable_update`, `agentia_testing_variable_delete` |

### Notes for common tools

- `agentia_work_set`, `agentia_work_publish`, and `agentia_work_submit` operate on the Git repository in the MCP server process's current working directory. They can check out a branch, fetch from, and push to `origin`; start the server from the intended repository. If `agentia_work_set` returns `status: "warning"`, it printed the gateway message and did not run git or update local work context. Work set fetches the base branch and, when that ref exists, the remote feature branch, then creates or checks out `feature/<user-story-name>` from the remote feature when present, otherwise from the base. Work set also compares the Copado Story source credential with the CICD project default after the work/set response: it warns when the Story credential is missing, skips comparison when a bound Story has no project default, and warns without changing the Story when they differ (current credential and environment are shown; use `agentia_work_update` / `cicd work update --source-credential` to change it).
- `agentia_ai_ask` mirrors `agentia ai agent ask --json`: it buffers the agent response, returns structured warnings/followups/links, and never returns hidden reasoning chunks. Plan, Build, and Test requests accept `credentialId`, `forceCredentialSync`, and `noCredentialSync` to control project-default Copado credential synchronization, plus `sfOrg` only as prompt context.
- Browser-based `cicd environment auth web login` remains a CLI-only command.
- Pipeline and job tools require `userId` and `organizationId` for the gateway `x-user-id` and `x-organization-id` headers.
- Job list accepts optional filters such as `status`, `name`, `type`, `parent`, `context`, and `limit`.
- Metadata tools require the same gateway identifiers as the CLI flags, for example `pipelineId`, `sourceOrgId`, and `sourceCredentialId` where applicable.
- Project list accepts optional `mine` to restrict results to projects owned by or related to the current user.
- Project default tools read and write local or global defaults managed by `agentia cicd project default *`.
- User get defaults `id` to `me` for the authenticated user.
- Environment create/update tools mirror the corresponding CLI commands and only send fields you provide.
- Work set/publish/submit/done tools mirror the CLI workflow: `set` prepares `feature/<user-story-name>`, then `publish` / `submit` / `done` operate on the current feature branch with the same clean-tree and base-branch requirements. `agentia_work_push` remains a compatibility alias of `agentia_work_publish`.
- `agentia_cloud_commit` requires `metadataCategory` for simple input, and each `changes` entry requires `c` (or `category`). For Salesforce metadata set `SFDX`. Copado SFDX deploy classifies changeset rows by that field; omitting it logs "Salesforce changes not found." and skips the deploy.
- Work deployment-step tools mirror `cicd work deployment-step *`; create accepts either the resolved inner `configJson` or the same type-specific guided fields as the CLI, update uses `null` to clear nullable fields, and reorder requires complete `before` and `after` ID arrays.
- Promotion list accepts the same filters as `agentia cicd promotion list`; promotion get takes a Promotion ID. `agentia_promotion_job_step_update` mirrors `cicd promotion job-step update`, validates sparse manual-task updates, and trims assignee values. `agentia_promotion_run` and `agentia_cloud_promote` reuse the CLI preflight, run/resume, ordered deployment-step, and bounded polling behavior.
- `agentia_notification_configure` mirrors `agentia cicd notification configure`: Slack-only subscriptions on a pipeline for the current user. Resolve the pipeline Id with `agentia_pipeline_get` first. All fields are required (`pipelineId`, `event`, `destinationType`, `destinationId`, `subscription`). Event names with spaces use the same underscore tokens as the CLI (for example `Test_Not Started`).
- `agentia_notification_get` mirrors `agentia cicd notification get`: requires `pipelineId` and returns sanitized `{ pipelineId, subscriptions }` for the authenticated user (no raw system-property metadata).

## CRT Git-backed jobs

Use Git storage when CRT should fetch Robot Framework files from a repository branch instead of uploading local files into a snapshot job.

```sh
agentia testing job create \
  --project 112901 \
  --robot 123456 \
  --name "Login smoke from Git" \
  --git-url https://github.com/acme/crt-tests.git \
  --git-branch feature/login-smoke
```

For private repositories, prefer a CRT domain credential:

```sh
agentia testing job create \
  --project 112901 \
  --robot 123456 \
  --name "Login smoke from Git" \
  --git-url https://github.com/acme/private-crt-tests.git \
  --git-branch feature/login-smoke \
  --git-domain-credential 017f22e2-79b0-7cc3-98c4-2e1d13e9b1aa
```

Run the Git-backed job from a branch and wait for the result:

```sh
agentia testing job run 196473 \
  --project 112901 \
  --branch feature/login-smoke
```

Runs wait for a terminal result and exit non-zero when the run fails. Pass `--no-wait` to return as
soon as the run is queued, or `--no-exit-code` to keep a failed run from failing the command.
MCP `agentia_testing_job_run` does not wait unless `waitForResult` or `streamLogs` is set, and it
rejects those options on data-driven runs.

Update an existing job to point at a different Git branch:

```sh
agentia testing job update 196473 \
  --project 112901 \
  --git-branch feature/login-smoke
```

`--git-branch` and `--git-tag` configure the job storage. `--branch` and `--tag` on run commands choose the Git ref used for a specific execution.

# Local Quality Gates

`agentia cicd work test` (local by default) runs the project-root `.agentia_quality_gates.sh` (macOS/Linux) or `.agentia_quality_gates.cmd` (Windows) script when present. If those files are missing, it warns and runs the stock sample from a temporary file. `agentia cicd work submit` runs the same project script when present and skips local gates when they are missing. Both report the result on the current `feature/<user-story-name>` work item. Run `agentia setup` and accept the local quality gates prompt to persist sample scripts. Sample scripts always call `agentia cicd work test apex`; an empty `AGENTIA_APEX_TEST_CLASSES` list skips Apex without failing the script, instead of invoking `sf apex run test` directly. `work test --rerun-failed-apex-tests` sets `AGENTIA_APEX_RERUN_FAILED` to `--rerun-failed-apex-tests` (empty otherwise) so the sample Apex one-liner can append that flag and rerun classes saved in `.agentia/apex.tests.<user-story>.json`. Repeatable `-e` / `--env NAME=value` injects extra variables into the script environment (MCP `env`); reserved `AGENTIA_APEX_*` values from dedicated flags still win.

## Prerequisites

This feature requires an Extension Configuration in Copado with:

| Field          | Value                |
| -------------- | -------------------- |
| Name           | `Local Quality Gate` |
| Copado Phase   | `Test`               |
| Extension Tool | `None`               |
| Test Type      | `Unit Test`          |

Without it, Copado cannot record the local quality gates run on the user story.

# License

Agentia CLI is distributed under the Copado End User License Agreement. See [LICENSE.md](LICENSE.md) for the full license terms.

# Commands

<!-- commands -->
* [`agentia adv auth status`](#agentia-adv-auth-status)
* [`agentia adv component add DEPLOYMENT-ID`](#agentia-adv-component-add-deployment-id)
* [`agentia adv component list`](#agentia-adv-component-list)
* [`agentia adv component refresh`](#agentia-adv-component-refresh)
* [`agentia adv component remove DEPLOYMENT-ID`](#agentia-adv-component-remove-deployment-id)
* [`agentia adv component selected DEPLOYMENT-ID`](#agentia-adv-component-selected-deployment-id)
* [`agentia adv component types`](#agentia-adv-component-types)
* [`agentia adv deployment cancel ID`](#agentia-adv-deployment-cancel-id)
* [`agentia adv deployment create`](#agentia-adv-deployment-create)
* [`agentia adv deployment deploy ID`](#agentia-adv-deployment-deploy-id)
* [`agentia adv deployment get ID`](#agentia-adv-deployment-get-id)
* [`agentia adv deployment list`](#agentia-adv-deployment-list)
* [`agentia adv deployment options ID`](#agentia-adv-deployment-options-id)
* [`agentia adv deployment quick-deploy ID`](#agentia-adv-deployment-quick-deploy-id)
* [`agentia adv deployment validate ID`](#agentia-adv-deployment-validate-id)
* [`agentia adv job get DEPLOYMENT-ID`](#agentia-adv-job-get-deployment-id)
* [`agentia adv job list DEPLOYMENT-ID`](#agentia-adv-job-list-deployment-id)
* [`agentia adv job wait DEPLOYMENT-ID`](#agentia-adv-job-wait-deployment-id)
* [`agentia adv organization get ID`](#agentia-adv-organization-get-id)
* [`agentia adv organization list`](#agentia-adv-organization-list)
* [`agentia adv organization validate ID`](#agentia-adv-organization-validate-id)
* [`agentia ai agent ask`](#agentia-ai-agent-ask)
* [`agentia ai agent chat`](#agentia-ai-agent-chat)
* [`agentia ai quota get`](#agentia-ai-quota-get)
* [`agentia ai workspace create`](#agentia-ai-workspace-create)
* [`agentia ai workspace get ID`](#agentia-ai-workspace-get-id)
* [`agentia ai workspace list`](#agentia-ai-workspace-list)
* [`agentia ai workspace member invite WORKSPACE`](#agentia-ai-workspace-member-invite-workspace)
* [`agentia ai workspace member list WORKSPACE`](#agentia-ai-workspace-member-list-workspace)
* [`agentia ai workspace update ID`](#agentia-ai-workspace-update-id)
* [`agentia auth get`](#agentia-auth-get)
* [`agentia auth set`](#agentia-auth-set)
* [`agentia auth unset`](#agentia-auth-unset)
* [`agentia cicd cloud commit [ID]`](#agentia-cicd-cloud-commit-id)
* [`agentia cicd cloud promote [ID]`](#agentia-cicd-cloud-promote-id)
* [`agentia cicd credential auth status ID`](#agentia-cicd-credential-auth-status-id)
* [`agentia cicd credential auth web login ID`](#agentia-cicd-credential-auth-web-login-id)
* [`agentia cicd credential create`](#agentia-cicd-credential-create)
* [`agentia cicd credential list`](#agentia-cicd-credential-list)
* [`agentia cicd credential open ID`](#agentia-cicd-credential-open-id)
* [`agentia cicd credential update ID`](#agentia-cicd-credential-update-id)
* [`agentia cicd data commit create`](#agentia-cicd-data-commit-create)
* [`agentia cicd data commit list USERSTORYID`](#agentia-cicd-data-commit-list-userstoryid)
* [`agentia cicd data dataset-file content CONTENTVERSIONID`](#agentia-cicd-data-dataset-file-content-contentversionid)
* [`agentia cicd data dataset-file list USERSTORYDATACOMMITID`](#agentia-cicd-data-dataset-file-list-userstorydatacommitid)
* [`agentia cicd data filter add DATATEMPLATEID`](#agentia-cicd-data-filter-add-datatemplateid)
* [`agentia cicd data filter delete DATATEMPLATEID UUID`](#agentia-cicd-data-filter-delete-datatemplateid-uuid)
* [`agentia cicd data filter list DATATEMPLATEID`](#agentia-cicd-data-filter-list-datatemplateid)
* [`agentia cicd data filter update DATATEMPLATEID UUID`](#agentia-cicd-data-filter-update-datatemplateid-uuid)
* [`agentia cicd data formula create DATATEMPLATEID`](#agentia-cicd-data-formula-create-datatemplateid)
* [`agentia cicd data formula list OBJECTAPINAME`](#agentia-cicd-data-formula-list-objectapiname)
* [`agentia cicd data formula update FORMULAID`](#agentia-cicd-data-formula-update-formulaid)
* [`agentia cicd data records match`](#agentia-cicd-data-records-match)
* [`agentia cicd data records search`](#agentia-cicd-data-records-search)
* [`agentia cicd data sobject fields SOBJECTAPINAME`](#agentia-cicd-data-sobject-fields-sobjectapiname)
* [`agentia cicd data sobject relationships SOBJECTAPINAME`](#agentia-cicd-data-sobject-relationships-sobjectapiname)
* [`agentia cicd data sync apply`](#agentia-cicd-data-sync-apply)
* [`agentia cicd data sync preview-updates`](#agentia-cicd-data-sync-preview-updates)
* [`agentia cicd data template convert-old ID`](#agentia-cicd-data-template-convert-old-id)
* [`agentia cicd data template create`](#agentia-cicd-data-template-create)
* [`agentia cicd data template delete ID`](#agentia-cicd-data-template-delete-id)
* [`agentia cicd data template get ID`](#agentia-cicd-data-template-get-id)
* [`agentia cicd data template get-detail ID`](#agentia-cicd-data-template-get-detail-id)
* [`agentia cicd data template list`](#agentia-cicd-data-template-list)
* [`agentia cicd data template open ID`](#agentia-cicd-data-template-open-id)
* [`agentia cicd data template save-detail ID`](#agentia-cicd-data-template-save-detail-id)
* [`agentia cicd environment auth status [ID]`](#agentia-cicd-environment-auth-status-id)
* [`agentia cicd environment auth web login [ID]`](#agentia-cicd-environment-auth-web-login-id)
* [`agentia cicd environment create NAME`](#agentia-cicd-environment-create-name)
* [`agentia cicd environment get ID`](#agentia-cicd-environment-get-id)
* [`agentia cicd environment list`](#agentia-cicd-environment-list)
* [`agentia cicd environment open [ID]`](#agentia-cicd-environment-open-id)
* [`agentia cicd environment update ID`](#agentia-cicd-environment-update-id)
* [`agentia cicd extension-configuration get ID`](#agentia-cicd-extension-configuration-get-id)
* [`agentia cicd extension-configuration list`](#agentia-cicd-extension-configuration-list)
* [`agentia cicd extension-configuration open ID`](#agentia-cicd-extension-configuration-open-id)
* [`agentia cicd extension create`](#agentia-cicd-extension-create)
* [`agentia cicd extension install [SOURCE]`](#agentia-cicd-extension-install-source)
* [`agentia cicd extension package`](#agentia-cicd-extension-package)
* [`agentia cicd extension publish`](#agentia-cicd-extension-publish)
* [`agentia cicd extension uninstall [SOURCE]`](#agentia-cicd-extension-uninstall-source)
* [`agentia cicd extension validate`](#agentia-cicd-extension-validate)
* [`agentia cicd function defaults`](#agentia-cicd-function-defaults)
* [`agentia cicd function delete API-NAME`](#agentia-cicd-function-delete-api-name)
* [`agentia cicd function get API-NAME`](#agentia-cicd-function-get-api-name)
* [`agentia cicd function list`](#agentia-cicd-function-list)
* [`agentia cicd function open ID`](#agentia-cicd-function-open-id)
* [`agentia cicd function result get RESULT-ID`](#agentia-cicd-function-result-get-result-id)
* [`agentia cicd function result log get RESULT-ID`](#agentia-cicd-function-result-log-get-result-id)
* [`agentia cicd function run API-NAME`](#agentia-cicd-function-run-api-name)
* [`agentia cicd function run-local SCRIPT`](#agentia-cicd-function-run-local-script)
* [`agentia cicd function upsert API-NAME`](#agentia-cicd-function-upsert-api-name)
* [`agentia cicd health-check`](#agentia-cicd-health-check)
* [`agentia cicd job get ID`](#agentia-cicd-job-get-id)
* [`agentia cicd job kill ID`](#agentia-cicd-job-kill-id)
* [`agentia cicd job list`](#agentia-cicd-job-list)
* [`agentia cicd job log get ID`](#agentia-cicd-job-log-get-id)
* [`agentia cicd job open ID`](#agentia-cicd-job-open-id)
* [`agentia cicd job pause ID`](#agentia-cicd-job-pause-id)
* [`agentia cicd job result-file get RESULTID`](#agentia-cicd-job-result-file-get-resultid)
* [`agentia cicd job result-file list RESULTID`](#agentia-cicd-job-result-file-list-resultid)
* [`agentia cicd job resume ID`](#agentia-cicd-job-resume-id)
* [`agentia cicd job run ID`](#agentia-cicd-job-run-id)
* [`agentia cicd metadata content compare`](#agentia-cicd-metadata-content-compare)
* [`agentia cicd metadata content get`](#agentia-cicd-metadata-content-get)
* [`agentia cicd metadata dependency list`](#agentia-cicd-metadata-dependency-list)
* [`agentia cicd metadata explore`](#agentia-cicd-metadata-explore)
* [`agentia cicd metadata index compare`](#agentia-cicd-metadata-index-compare)
* [`agentia cicd metadata list`](#agentia-cicd-metadata-list)
* [`agentia cicd metadata refresh deleted`](#agentia-cicd-metadata-refresh-deleted)
* [`agentia cicd metadata refresh run`](#agentia-cicd-metadata-refresh-run)
* [`agentia cicd metadata refresh status`](#agentia-cicd-metadata-refresh-status)
* [`agentia cicd notification configure`](#agentia-cicd-notification-configure)
* [`agentia cicd notification get`](#agentia-cicd-notification-get)
* [`agentia cicd pipeline automation activate ID`](#agentia-cicd-pipeline-automation-activate-id)
* [`agentia cicd pipeline automation create`](#agentia-cicd-pipeline-automation-create)
* [`agentia cicd pipeline automation deactivate ID`](#agentia-cicd-pipeline-automation-deactivate-id)
* [`agentia cicd pipeline automation delete ID`](#agentia-cicd-pipeline-automation-delete-id)
* [`agentia cicd pipeline automation get ID`](#agentia-cicd-pipeline-automation-get-id)
* [`agentia cicd pipeline automation list`](#agentia-cicd-pipeline-automation-list)
* [`agentia cicd pipeline automation open ID`](#agentia-cicd-pipeline-automation-open-id)
* [`agentia cicd pipeline automation update ID`](#agentia-cicd-pipeline-automation-update-id)
* [`agentia cicd pipeline connection create`](#agentia-cicd-pipeline-connection-create)
* [`agentia cicd pipeline connection delete`](#agentia-cicd-pipeline-connection-delete)
* [`agentia cicd pipeline connection list`](#agentia-cicd-pipeline-connection-list)
* [`agentia cicd pipeline connection open ID`](#agentia-cicd-pipeline-connection-open-id)
* [`agentia cicd pipeline connection update`](#agentia-cicd-pipeline-connection-update)
* [`agentia cicd pipeline create NAME`](#agentia-cicd-pipeline-create-name)
* [`agentia cicd pipeline get ID`](#agentia-cicd-pipeline-get-id)
* [`agentia cicd pipeline list`](#agentia-cicd-pipeline-list)
* [`agentia cicd pipeline open ID`](#agentia-cicd-pipeline-open-id)
* [`agentia cicd pipeline quality-gate activate ID`](#agentia-cicd-pipeline-quality-gate-activate-id)
* [`agentia cicd pipeline quality-gate create`](#agentia-cicd-pipeline-quality-gate-create)
* [`agentia cicd pipeline quality-gate deactivate ID`](#agentia-cicd-pipeline-quality-gate-deactivate-id)
* [`agentia cicd pipeline quality-gate delete ID`](#agentia-cicd-pipeline-quality-gate-delete-id)
* [`agentia cicd pipeline quality-gate get ID`](#agentia-cicd-pipeline-quality-gate-get-id)
* [`agentia cicd pipeline quality-gate list`](#agentia-cicd-pipeline-quality-gate-list)
* [`agentia cicd pipeline quality-gate open ID`](#agentia-cicd-pipeline-quality-gate-open-id)
* [`agentia cicd pipeline quality-gate update ID`](#agentia-cicd-pipeline-quality-gate-update-id)
* [`agentia cicd pipeline stage-connection create`](#agentia-cicd-pipeline-stage-connection-create)
* [`agentia cicd pipeline stage-connection delete ID`](#agentia-cicd-pipeline-stage-connection-delete-id)
* [`agentia cicd pipeline stage-connection list`](#agentia-cicd-pipeline-stage-connection-list)
* [`agentia cicd pipeline stage-connection open ID`](#agentia-cicd-pipeline-stage-connection-open-id)
* [`agentia cicd pipeline stage-connection update ID`](#agentia-cicd-pipeline-stage-connection-update-id)
* [`agentia cicd pipeline update ID`](#agentia-cicd-pipeline-update-id)
* [`agentia cicd project create NAME`](#agentia-cicd-project-create-name)
* [`agentia cicd project default get`](#agentia-cicd-project-default-get)
* [`agentia cicd project default set`](#agentia-cicd-project-default-set)
* [`agentia cicd project default unset`](#agentia-cicd-project-default-unset)
* [`agentia cicd project delete ID`](#agentia-cicd-project-delete-id)
* [`agentia cicd project get ID`](#agentia-cicd-project-get-id)
* [`agentia cicd project list`](#agentia-cicd-project-list)
* [`agentia cicd project open [ID]`](#agentia-cicd-project-open-id)
* [`agentia cicd project update ID`](#agentia-cicd-project-update-id)
* [`agentia cicd promotion conflict get ID`](#agentia-cicd-promotion-conflict-get-id)
* [`agentia cicd promotion conflict list`](#agentia-cicd-promotion-conflict-list)
* [`agentia cicd promotion conflict resolve ID`](#agentia-cicd-promotion-conflict-resolve-id)
* [`agentia cicd promotion conflict unresolve ID`](#agentia-cicd-promotion-conflict-unresolve-id)
* [`agentia cicd promotion get ID`](#agentia-cicd-promotion-get-id)
* [`agentia cicd promotion job-step update ID`](#agentia-cicd-promotion-job-step-update-id)
* [`agentia cicd promotion list`](#agentia-cicd-promotion-list)
* [`agentia cicd promotion open ID`](#agentia-cicd-promotion-open-id)
* [`agentia cicd promotion run ID`](#agentia-cicd-promotion-run-id)
* [`agentia cicd repository auth https configure ID`](#agentia-cicd-repository-auth-https-configure-id)
* [`agentia cicd repository auth oauth login ID`](#agentia-cicd-repository-auth-oauth-login-id)
* [`agentia cicd repository auth setup ID`](#agentia-cicd-repository-auth-setup-id)
* [`agentia cicd repository auth ssh configure ID`](#agentia-cicd-repository-auth-ssh-configure-id)
* [`agentia cicd repository create NAME`](#agentia-cicd-repository-create-name)
* [`agentia cicd repository delete ID`](#agentia-cicd-repository-delete-id)
* [`agentia cicd repository get ID`](#agentia-cicd-repository-get-id)
* [`agentia cicd repository list`](#agentia-cicd-repository-list)
* [`agentia cicd repository open ID`](#agentia-cicd-repository-open-id)
* [`agentia cicd repository reset ID`](#agentia-cicd-repository-reset-id)
* [`agentia cicd repository update ID`](#agentia-cicd-repository-update-id)
* [`agentia cicd repository validate ID`](#agentia-cicd-repository-validate-id)
* [`agentia cicd stage create NAME`](#agentia-cicd-stage-create-name)
* [`agentia cicd stage delete ID`](#agentia-cicd-stage-delete-id)
* [`agentia cicd stage get ID`](#agentia-cicd-stage-get-id)
* [`agentia cicd stage list`](#agentia-cicd-stage-list)
* [`agentia cicd stage open ID`](#agentia-cicd-stage-open-id)
* [`agentia cicd stage update ID`](#agentia-cicd-stage-update-id)
* [`agentia cicd template defaults`](#agentia-cicd-template-defaults)
* [`agentia cicd template delete API-NAME`](#agentia-cicd-template-delete-api-name)
* [`agentia cicd template get API-NAME`](#agentia-cicd-template-get-api-name)
* [`agentia cicd template list`](#agentia-cicd-template-list)
* [`agentia cicd template upsert API-NAME`](#agentia-cicd-template-upsert-api-name)
* [`agentia cicd user get`](#agentia-cicd-user-get)
* [`agentia cicd work ahead-behind [ENVIRONMENT]`](#agentia-cicd-work-ahead-behind-environment)
* [`agentia cicd work create`](#agentia-cicd-work-create)
* [`agentia cicd work delete ID`](#agentia-cicd-work-delete-id)
* [`agentia cicd work deployment-step create`](#agentia-cicd-work-deployment-step-create)
* [`agentia cicd work deployment-step delete`](#agentia-cicd-work-deployment-step-delete)
* [`agentia cicd work deployment-step list`](#agentia-cicd-work-deployment-step-list)
* [`agentia cicd work deployment-step reorder`](#agentia-cicd-work-deployment-step-reorder)
* [`agentia cicd work deployment-step salesforce-flows`](#agentia-cicd-work-deployment-step-salesforce-flows)
* [`agentia cicd work deployment-step types`](#agentia-cicd-work-deployment-step-types)
* [`agentia cicd work deployment-step update`](#agentia-cicd-work-deployment-step-update)
* [`agentia cicd work done`](#agentia-cicd-work-done)
* [`agentia cicd work environment-sync`](#agentia-cicd-work-environment-sync)
* [`agentia cicd work get [ID]`](#agentia-cicd-work-get-id)
* [`agentia cicd work list`](#agentia-cicd-work-list)
* [`agentia cicd work open [ID]`](#agentia-cicd-work-open-id)
* [`agentia cicd work promote [USERSTORYIDS]`](#agentia-cicd-work-promote-userstoryids)
* [`agentia cicd work publish`](#agentia-cicd-work-publish)
* [`agentia cicd work push`](#agentia-cicd-work-push)
* [`agentia cicd work set [ID]`](#agentia-cicd-work-set-id)
* [`agentia cicd work status [ID]`](#agentia-cicd-work-status-id)
* [`agentia cicd work submit`](#agentia-cicd-work-submit)
* [`agentia cicd work test`](#agentia-cicd-work-test)
* [`agentia cicd work test apex`](#agentia-cicd-work-test-apex)
* [`agentia cicd work update [ID]`](#agentia-cicd-work-update-id)
* [`agentia help [COMMAND]`](#agentia-help-command)
* [`agentia mcp start`](#agentia-mcp-start)
* [`agentia plugins`](#agentia-plugins)
* [`agentia plugins add PLUGIN`](#agentia-plugins-add-plugin)
* [`agentia plugins:inspect PLUGIN...`](#agentia-pluginsinspect-plugin)
* [`agentia plugins install PLUGIN`](#agentia-plugins-install-plugin)
* [`agentia plugins link PATH`](#agentia-plugins-link-path)
* [`agentia plugins remove [PLUGIN]`](#agentia-plugins-remove-plugin)
* [`agentia plugins reset`](#agentia-plugins-reset)
* [`agentia plugins uninstall [PLUGIN]`](#agentia-plugins-uninstall-plugin)
* [`agentia plugins unlink [PLUGIN]`](#agentia-plugins-unlink-plugin)
* [`agentia plugins update`](#agentia-plugins-update)
* [`agentia setup`](#agentia-setup)
* [`agentia setup skills create`](#agentia-setup-skills-create)
* [`agentia setup skills list`](#agentia-setup-skills-list)
* [`agentia setup skills update`](#agentia-setup-skills-update)
* [`agentia testing data-table create`](#agentia-testing-data-table-create)
* [`agentia testing data-table delete ID`](#agentia-testing-data-table-delete-id)
* [`agentia testing data-table export ID`](#agentia-testing-data-table-export-id)
* [`agentia testing data-table get ID`](#agentia-testing-data-table-get-id)
* [`agentia testing data-table list`](#agentia-testing-data-table-list)
* [`agentia testing data-table update ID`](#agentia-testing-data-table-update-id)
* [`agentia testing job create`](#agentia-testing-job-create)
* [`agentia testing job delete ID`](#agentia-testing-job-delete-id)
* [`agentia testing job files download ID`](#agentia-testing-job-files-download-id)
* [`agentia testing job files list ID`](#agentia-testing-job-files-list-id)
* [`agentia testing job files upload ID`](#agentia-testing-job-files-upload-id)
* [`agentia testing job get ID`](#agentia-testing-job-get-id)
* [`agentia testing job list`](#agentia-testing-job-list)
* [`agentia testing job refs ID`](#agentia-testing-job-refs-id)
* [`agentia testing job run ID`](#agentia-testing-job-run-id)
* [`agentia testing job runs abort ID`](#agentia-testing-job-runs-abort-id)
* [`agentia testing job runs get ID`](#agentia-testing-job-runs-get-id)
* [`agentia testing job runs list`](#agentia-testing-job-runs-list)
* [`agentia testing job runs logs ID`](#agentia-testing-job-runs-logs-id)
* [`agentia testing job runs search`](#agentia-testing-job-runs-search)
* [`agentia testing job schedule get ID`](#agentia-testing-job-schedule-get-id)
* [`agentia testing job schedule remove ID`](#agentia-testing-job-schedule-remove-id)
* [`agentia testing job schedule set ID`](#agentia-testing-job-schedule-set-id)
* [`agentia testing job update ID`](#agentia-testing-job-update-id)
* [`agentia testing live continue [JOB-ID]`](#agentia-testing-live-continue-job-id)
* [`agentia testing live execute [JOB-ID]`](#agentia-testing-live-execute-job-id)
* [`agentia testing live history [JOB-ID]`](#agentia-testing-live-history-job-id)
* [`agentia testing live inspect [JOB-ID]`](#agentia-testing-live-inspect-job-id)
* [`agentia testing live interrupt [JOB-ID]`](#agentia-testing-live-interrupt-job-id)
* [`agentia testing live recorder [JOB-ID]`](#agentia-testing-live-recorder-job-id)
* [`agentia testing live reports [JOB-ID]`](#agentia-testing-live-reports-job-id)
* [`agentia testing live screenshot [JOB-ID]`](#agentia-testing-live-screenshot-job-id)
* [`agentia testing live set-options [JOB-ID]`](#agentia-testing-live-set-options-job-id)
* [`agentia testing live start JOB-ID`](#agentia-testing-live-start-job-id)
* [`agentia testing live status [JOB-ID]`](#agentia-testing-live-status-job-id)
* [`agentia testing live stop [JOB-ID]`](#agentia-testing-live-stop-job-id)
* [`agentia testing live view`](#agentia-testing-live-view)
* [`agentia testing project create`](#agentia-testing-project-create)
* [`agentia testing project delete ID`](#agentia-testing-project-delete-id)
* [`agentia testing project get ID`](#agentia-testing-project-get-id)
* [`agentia testing project list`](#agentia-testing-project-list)
* [`agentia testing project permission get PROJECT`](#agentia-testing-project-permission-get-project)
* [`agentia testing project permission list PROJECT`](#agentia-testing-project-permission-list-project)
* [`agentia testing project permission set PROJECT`](#agentia-testing-project-permission-set-project)
* [`agentia testing project permission update PROJECT`](#agentia-testing-project-permission-update-project)
* [`agentia testing project update ID`](#agentia-testing-project-update-id)
* [`agentia testing robot create`](#agentia-testing-robot-create)
* [`agentia testing robot delete ID`](#agentia-testing-robot-delete-id)
* [`agentia testing robot get ID`](#agentia-testing-robot-get-id)
* [`agentia testing robot list`](#agentia-testing-robot-list)
* [`agentia testing robot update ID`](#agentia-testing-robot-update-id)
* [`agentia testing user-parameter create`](#agentia-testing-user-parameter-create)
* [`agentia testing user-parameter delete ID`](#agentia-testing-user-parameter-delete-id)
* [`agentia testing user-parameter get ID`](#agentia-testing-user-parameter-get-id)
* [`agentia testing user-parameter list`](#agentia-testing-user-parameter-list)
* [`agentia testing user-parameter update ID`](#agentia-testing-user-parameter-update-id)
* [`agentia testing variable create`](#agentia-testing-variable-create)
* [`agentia testing variable delete ID`](#agentia-testing-variable-delete-id)
* [`agentia testing variable get ID`](#agentia-testing-variable-get-id)
* [`agentia testing variable list`](#agentia-testing-variable-list)
* [`agentia testing variable update ID`](#agentia-testing-variable-update-id)
* [`agentia update`](#agentia-update)

## `agentia adv auth status`

Check the configured Pipelines Advanced PAT

```
USAGE
  $ agentia adv auth status [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Check the configured Pipelines Advanced PAT

EXAMPLES
  $ agentia adv auth status

  $ agentia adv auth status --json
```

_See code: [src/commands/adv/auth/status.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/auth/status.ts)_

## `agentia adv component add DEPLOYMENT-ID`

Add components to a Pipelines Advanced deployment selection

```
USAGE
  $ agentia adv component add DEPLOYMENT-ID [--json] [--component <value>... | --file <value> | --json-file <value>]

ARGUMENTS
  DEPLOYMENT-ID  Pipelines Advanced deployment ID.

FLAGS
  --component=<value>...  Component to add as Type/Name; repeat for multiple components.
  --file=<value>          Text file with one Type/Name component per line.
  --json-file=<value>     JSON file containing a bare component array (not a --json envelope); accepts list rows, {type,
                          fullName}, or {nodeType: {name}, fullName}.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Add components to a Pipelines Advanced deployment selection

EXAMPLES
  $ agentia adv component add 1025 --component ApexClass/Foo --component ApexClass/Bar

  $ agentia adv component add 1025 --file components.txt

  $ agentia adv component add 1025 --json-file components.json
```

_See code: [src/commands/adv/component/add.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/component/add.ts)_

## `agentia adv component list`

List source components for a Pipelines Advanced deployment

```
USAGE
  $ agentia adv component list --flow <value> --type <value> [--json] [--include-managed-package]

FLAGS
  --flow=<value>             (required) Pipelines Advanced deployment ID.
  --include-managed-package  Include managed package components.
  --type=<value>             (required) Comma-separated component type names.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List source components for a Pipelines Advanced deployment

EXAMPLES
  $ agentia adv component list --flow 1025 --type ApexClass

  $ agentia adv component list --flow 1025 --type ApexClass,ApexTrigger --include-managed-package
```

_See code: [src/commands/adv/component/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/component/list.ts)_

## `agentia adv component refresh`

Refresh Pipelines Advanced component comparison cache

```
USAGE
  $ agentia adv component refresh --flow <value> --type <value> [--json] [--full]

FLAGS
  --flow=<value>  (required) Pipelines Advanced deployment ID.
  --full          Delete cached comparison data before refreshing.
  --type=<value>  (required) Comma-separated component type names.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Refresh Pipelines Advanced component comparison cache

EXAMPLES
  $ agentia adv component refresh --flow 1025 --type ApexClass

  $ agentia adv component refresh --flow 1025 --type ApexClass,Flow --full
```

_See code: [src/commands/adv/component/refresh.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/component/refresh.ts)_

## `agentia adv component remove DEPLOYMENT-ID`

Remove components from a Pipelines Advanced deployment selection

```
USAGE
  $ agentia adv component remove DEPLOYMENT-ID [--json] [--component <value>... | --json-file <value>]

ARGUMENTS
  DEPLOYMENT-ID  Pipelines Advanced deployment ID.

FLAGS
  --component=<value>...  Component to remove as Type/Name; repeat for multiple components.
  --json-file=<value>     JSON file containing a bare component array (not a --json envelope); text-file input is not
                          supported.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Remove components from a Pipelines Advanced deployment selection

EXAMPLES
  $ agentia adv component remove 1025 --component ApexClass/Foo

  $ agentia adv component remove 1025 --json-file components.json
```

_See code: [src/commands/adv/component/remove.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/component/remove.ts)_

## `agentia adv component selected DEPLOYMENT-ID`

List components currently selected for a Pipelines Advanced deployment

```
USAGE
  $ agentia adv component selected DEPLOYMENT-ID [--json]

ARGUMENTS
  DEPLOYMENT-ID  Pipelines Advanced deployment ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List components currently selected for a Pipelines Advanced deployment

EXAMPLES
  $ agentia adv component selected 1025

  $ agentia adv component selected 1025 --json
```

_See code: [src/commands/adv/component/selected.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/component/selected.ts)_

## `agentia adv component types`

List Pipelines Advanced component type views; a component type can appear in multiple views

```
USAGE
  $ agentia adv component types [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Pipelines Advanced component type views; a component type can appear in multiple views

EXAMPLES
  $ agentia adv component types

  $ agentia adv component types --json
```

_See code: [src/commands/adv/component/types.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/component/types.ts)_

## `agentia adv deployment cancel ID`

Request cancellation of the current Pipelines Advanced run

```
USAGE
  $ agentia adv deployment cancel ID [--json] [--interval <value>] [--timeout <value>] [--wait] [-y]

ARGUMENTS
  ID  Pipelines Advanced deployment ID.

FLAGS
  -y, --yes               Confirm the action without prompting (required for --json or non-interactive runs).
      --interval=<value>  Seconds between job status polls when waiting (default: 3).
      --timeout=<value>   Maximum seconds to wait; the remote run continues after timeout (default: 3600).
      --wait              Wait for the accepted run to finish.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Request cancellation of the current Pipelines Advanced run

EXAMPLES
  $ agentia adv deployment cancel 1025

  $ agentia adv deployment cancel 1025 --yes --wait
```

_See code: [src/commands/adv/deployment/cancel.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/deployment/cancel.ts)_

## `agentia adv deployment create`

Create a Pipelines Advanced deployment between two organizations

```
USAGE
  $ agentia adv deployment create --name <value> --source-org <value> --target-org <value> [--json]

FLAGS
  --name=<value>        (required) Deployment name.
  --source-org=<value>  (required) Source organization ID.
  --target-org=<value>  (required) Target organization ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Pipelines Advanced deployment between two organizations

EXAMPLES
  $ agentia adv deployment create --name release-1 --source-org 910001 --target-org 910002

  $ agentia adv deployment create --name release-1 --source-org 910001 --target-org 910002 --json
```

_See code: [src/commands/adv/deployment/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/deployment/create.ts)_

## `agentia adv deployment deploy ID`

Start a Pipelines Advanced deploy run

```
USAGE
  $ agentia adv deployment deploy ID [--json] [--interval <value>] [--timeout <value>] [--wait] [-y]

ARGUMENTS
  ID  Pipelines Advanced deployment ID.

FLAGS
  -y, --yes               Confirm the action without prompting (required for --json or non-interactive runs).
      --interval=<value>  Seconds between job status polls when waiting (default: 3).
      --timeout=<value>   Maximum seconds to wait; the remote run continues after timeout (default: 3600).
      --wait              Wait for the accepted run to finish.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Start a Pipelines Advanced deploy run

EXAMPLES
  $ agentia adv deployment deploy 1025

  $ agentia adv deployment deploy 1025 --yes --wait --json
```

_See code: [src/commands/adv/deployment/deploy.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/deployment/deploy.ts)_

## `agentia adv deployment get ID`

Show one Pipelines Advanced deployment

```
USAGE
  $ agentia adv deployment get ID [--json]

ARGUMENTS
  ID  Pipelines Advanced deployment ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show one Pipelines Advanced deployment

EXAMPLES
  $ agentia adv deployment get 1025

  $ agentia adv deployment get 1025 --json
```

_See code: [src/commands/adv/deployment/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/deployment/get.ts)_

## `agentia adv deployment list`

List up to 500 Pipelines Advanced deployments visible to the PAT user; the API does not support filters

```
USAGE
  $ agentia adv deployment list [--json] [--include-archived]

FLAGS
  --include-archived  Include archived deployments.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List up to 500 Pipelines Advanced deployments visible to the PAT user; the API does not support filters

EXAMPLES
  $ agentia adv deployment list

  $ agentia adv deployment list --include-archived

  $ agentia adv deployment list --json
```

_See code: [src/commands/adv/deployment/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/deployment/list.ts)_

## `agentia adv deployment options ID`

Update Pipelines Advanced deployment options

```
USAGE
  $ agentia adv deployment options ID [--json] [--file <value> | --set <value>...]

ARGUMENTS
  ID  Pipelines Advanced deployment ID.

FLAGS
  --file=<value>    JSON file with deployment options to merge over the current options.
  --set=<value>...  Deployment option as name=value; true, false, null, and any finite JavaScript Number value
                    (including hex and exponent notation) are converted.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update Pipelines Advanced deployment options

EXAMPLES
  $ agentia adv deployment options 1025 --set deployOptionsIgnoreWarnings=false

  $ agentia adv deployment options 1025 --file options.json

  $ agentia adv deployment options 1025 --set deployOptionsTestLevel=RUN_LOCAL_TESTS --json
```

_See code: [src/commands/adv/deployment/options.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/deployment/options.ts)_

## `agentia adv deployment quick-deploy ID`

Start a Pipelines Advanced quick deploy run

```
USAGE
  $ agentia adv deployment quick-deploy ID [--json] [--interval <value>] [--timeout <value>] [--wait] [-y] [--backup]

ARGUMENTS
  ID  Pipelines Advanced deployment ID.

FLAGS
  -y, --yes               Confirm the action without prompting (required for --json or non-interactive runs).
      --backup            Run backupThenDeploy instead of a quick deploy; the returned action reflects backupThenDeploy.
      --interval=<value>  Seconds between job status polls when waiting (default: 3).
      --timeout=<value>   Maximum seconds to wait; the remote run continues after timeout (default: 3600).
      --wait              Wait for the accepted run to finish.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Start a Pipelines Advanced quick deploy run

EXAMPLES
  $ agentia adv deployment quick-deploy 1025

  $ agentia adv deployment quick-deploy 1025 --backup --yes --wait
```

_See code: [src/commands/adv/deployment/quick-deploy.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/deployment/quick-deploy.ts)_

## `agentia adv deployment validate ID`

Start a check-only Pipelines Advanced validation run

```
USAGE
  $ agentia adv deployment validate ID [--json] [--interval <value>] [--timeout <value>] [--wait]

ARGUMENTS
  ID  Pipelines Advanced deployment ID.

FLAGS
  --interval=<value>  Seconds between job status polls when waiting (default: 3).
  --timeout=<value>   Maximum seconds to wait; the remote run continues after timeout (default: 3600).
  --wait              Wait for the accepted run to finish.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Start a check-only Pipelines Advanced validation run

EXAMPLES
  $ agentia adv deployment validate 1025

  $ agentia adv deployment validate 1025 --wait
```

_See code: [src/commands/adv/deployment/validate.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/deployment/validate.ts)_

## `agentia adv job get DEPLOYMENT-ID`

Show the latest Pipelines Advanced run for a deployment

```
USAGE
  $ agentia adv job get DEPLOYMENT-ID [--json]

ARGUMENTS
  DEPLOYMENT-ID  Pipelines Advanced deployment ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show the latest Pipelines Advanced run for a deployment

EXAMPLES
  $ agentia adv job get 1025

  $ agentia adv job get 1025 --json
```

_See code: [src/commands/adv/job/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/job/get.ts)_

## `agentia adv job list DEPLOYMENT-ID`

List deploy and quick-deploy history for a Pipelines Advanced deployment; validation runs are not included

```
USAGE
  $ agentia adv job list DEPLOYMENT-ID [--json] [--page <value>] [--page-size <value>]

ARGUMENTS
  DEPLOYMENT-ID  Pipelines Advanced deployment ID.

FLAGS
  --page=<value>       Page number starting at 0 (default: 0).
  --page-size=<value>  Rows per page (default: 50; server maximum: 100).

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List deploy and quick-deploy history for a Pipelines Advanced deployment; validation runs are not included

EXAMPLES
  $ agentia adv job list 1025

  $ agentia adv job list 1025 --page 1 --page-size 25
```

_See code: [src/commands/adv/job/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/job/list.ts)_

## `agentia adv job wait DEPLOYMENT-ID`

Wait for the latest Pipelines Advanced run to finish

```
USAGE
  $ agentia adv job wait DEPLOYMENT-ID [--json] [--interval <value>] [--timeout <value>]

ARGUMENTS
  DEPLOYMENT-ID  Pipelines Advanced deployment ID.

FLAGS
  --interval=<value>  Seconds between job status polls (default: 3).
  --timeout=<value>   Maximum seconds to wait; the remote run continues after timeout (default: 3600).

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Wait for the latest Pipelines Advanced run to finish

EXAMPLES
  $ agentia adv job wait 1025

  $ agentia adv job wait 1025 --interval 5 --timeout 1800
```

_See code: [src/commands/adv/job/wait.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/job/wait.ts)_

## `agentia adv organization get ID`

Show one Pipelines Advanced organization

```
USAGE
  $ agentia adv organization get ID [--json]

ARGUMENTS
  ID  Pipelines Advanced organization ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show one Pipelines Advanced organization

EXAMPLES
  $ agentia adv organization get 910001

  $ agentia adv organization get 910001 --json
```

_See code: [src/commands/adv/organization/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/organization/get.ts)_

## `agentia adv organization list`

List Pipelines Advanced organizations visible to the PAT user

```
USAGE
  $ agentia adv organization list [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Pipelines Advanced organizations visible to the PAT user

EXAMPLES
  $ agentia adv organization list

  $ agentia adv organization list --json
```

_See code: [src/commands/adv/organization/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/organization/list.ts)_

## `agentia adv organization validate ID`

Validate that Pipelines Advanced can connect to an organization

```
USAGE
  $ agentia adv organization validate ID [--json]

ARGUMENTS
  ID  Pipelines Advanced organization ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Validate that Pipelines Advanced can connect to an organization

EXAMPLES
  $ agentia adv organization validate 910001

  $ agentia adv organization validate 910001 --json
```

_See code: [src/commands/adv/organization/validate.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/adv/organization/validate.ts)_

## `agentia ai agent ask`

Send a single-turn prompt to a Copado AI agent

```
USAGE
  $ agentia ai agent ask -p <value> [--json] [--agent orchestrate|plan|build|test|release|operate|knowledge]
    [--component <value>] [--credential-id <value>] [--dialogue <value>] [--timeout <value>] [--force-credential-sync]
    [--no-credential-sync] [--no-stream] [--sf-org <value>] [--user-story <value>] [--work-item <value>] [--workspace
    <value>]

FLAGS
  -p, --prompt=<value>         (required) Natural language instruction for the agent
      --agent=<option>         [default: orchestrate] AI agent to target (defaults to orchestrate, which routes to the
                               right specialist)
                               <options: orchestrate|plan|build|test|release|operate|knowledge>
      --component=<value>      Metadata component name to include in prompt context
      --credential-id=<value>  Copado credential ID that overrides the project default for workspace synchronization
      --dialogue=<value>       Copado AI dialogue UUID to reuse
      --force-credential-sync  Replace the cached Copado CICD workspace integration
      --no-credential-sync     Skip Copado CICD workspace credential synchronization
      --no-stream              Buffer the full response before printing in human mode
      --sf-org=<value>         Salesforce org or environment name to include in prompt context
      --timeout=<value>        AI gateway timeout in seconds for workspace, dialogue, and message calls
      --user-story=<value>     User story identifier to include in prompt context
      --work-item=<value>      Work item identifier to include in prompt context
      --workspace=<value>      Copado AI workspace UUID to reuse for a new dialogue

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Send a single-turn prompt to a Copado AI agent

EXAMPLES
  $ agentia ai agent ask -p "Why did the last promotion fail?"

  $ agentia ai agent ask --agent plan -p "Break this requirement into implementation steps"

  $ agentia ai agent ask --agent build -p "Generate an Apex handler outline" --sf-org test14 --user-story US-1042

  $ agentia ai agent ask --agent test -p "Create regression checks" --component LeadScoringHandler --json

  $ agentia ai agent ask --agent operate -p "Diagnose this deployment error" --timeout 240

  $ agentia ai agent ask --agent knowledge -p "Summarize our deployment guidance"
```

_See code: [src/commands/ai/agent/ask.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/ai/agent/ask.ts)_

## `agentia ai agent chat`

Start an interactive Copado AI agent chat session

```
USAGE
  $ agentia ai agent chat [--agent orchestrate|plan|build|test|release|operate|knowledge] [--component <value>]
    [--credential-id <value>] [--dialogue <value>] [--timeout <value>] [--force-credential-sync] [--no-credential-sync]
    [--sf-org <value>] [--user-story <value>] [--work-item <value>] [--workspace <value>]

FLAGS
  --agent=<option>         [default: orchestrate] AI agent to target (defaults to orchestrate, which routes to the right
                           specialist)
                           <options: orchestrate|plan|build|test|release|operate|knowledge>
  --component=<value>      Metadata component name to include in prompt context
  --credential-id=<value>  Copado credential ID that overrides the project default for workspace synchronization
  --dialogue=<value>       Copado AI dialogue UUID to reuse
  --force-credential-sync  Replace the cached Copado CICD workspace integration
  --no-credential-sync     Skip Copado CICD workspace credential synchronization
  --sf-org=<value>         Salesforce org or environment name to include in prompt context
  --timeout=<value>        AI gateway timeout in seconds for workspace, dialogue, and message calls
  --user-story=<value>     User story identifier to include in prompt context
  --work-item=<value>      Work item identifier to include in prompt context
  --workspace=<value>      Copado AI workspace UUID to reuse for a new dialogue

DESCRIPTION
  Start an interactive Copado AI agent chat session

EXAMPLES
  $ agentia ai agent chat

  $ agentia ai agent chat --agent plan --sf-org test14

  $ agentia ai agent chat --agent build --user-story US-1042 --timeout 240

  $ agentia ai agent chat --agent knowledge

  $ agentia ai agent chat --workspace 42d0b908-37b7-4565-9ec9-86eda40c9782
```

_See code: [src/commands/ai/agent/chat.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/ai/agent/chat.ts)_

## `agentia ai quota get`

Get Copado AI organization quota

```
USAGE
  $ agentia ai quota get [--json] [--timeout <value>]

FLAGS
  --timeout=<value>  AI gateway timeout in seconds.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get Copado AI organization quota

EXAMPLES
  $ agentia ai quota get

  $ agentia ai quota get --json
```

_See code: [src/commands/ai/quota/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/ai/quota/get.ts)_

## `agentia ai workspace create`

Create a Copado AI workspace

```
USAGE
  $ agentia ai workspace create --name <value> [--json] [--timeout <value>] [--capability
    AgentFramework|Artifacts|CRTKnowledge|CustomKnowledge|DeepResearch|EssentialsKnowledge|LongTermMemory|Mermaid|Metada
    taFormatKnowledge|Mindmap|OtherKnowledge|Reasoning|SourceFormatKnowledge|STEM|TabularData|WebSearch...]
    [--description <value>]

FLAGS
  --capability=<option>...  Workspace capability. Can be provided multiple times.
                            <options: AgentFramework|Artifacts|CRTKnowledge|CustomKnowledge|DeepResearch|EssentialsKnowl
                            edge|LongTermMemory|Mermaid|MetadataFormatKnowledge|Mindmap|OtherKnowledge|Reasoning|SourceF
                            ormatKnowledge|STEM|TabularData|WebSearch>
  --description=<value>     Workspace description.
  --name=<value>            (required) Workspace name.
  --timeout=<value>         AI gateway timeout in seconds.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado AI workspace

EXAMPLES
  $ agentia ai workspace create --name "Agentia CLI"

  $ agentia ai workspace create --name "Agentia CLI" --description "CLI workspace" --capability Reasoning --capability CustomKnowledge
```

_See code: [src/commands/ai/workspace/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/ai/workspace/create.ts)_

## `agentia ai workspace get ID`

Get a Copado AI workspace

```
USAGE
  $ agentia ai workspace get ID [--json] [--timeout <value>]

ARGUMENTS
  ID  Copado AI workspace UUID.

FLAGS
  --timeout=<value>  AI gateway timeout in seconds.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado AI workspace

EXAMPLES
  $ agentia ai workspace get 42d0b908-37b7-4565-9ec9-86eda40c9782

  $ agentia ai workspace get 42d0b908-37b7-4565-9ec9-86eda40c9782 --json
```

_See code: [src/commands/ai/workspace/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/ai/workspace/get.ts)_

## `agentia ai workspace list`

List Copado AI workspaces

```
USAGE
  $ agentia ai workspace list [--json] [--timeout <value>]

FLAGS
  --timeout=<value>  AI gateway timeout in seconds.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado AI workspaces

EXAMPLES
  $ agentia ai workspace list

  $ agentia ai workspace list --json
```

_See code: [src/commands/ai/workspace/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/ai/workspace/list.ts)_

## `agentia ai workspace member invite WORKSPACE`

Invite a member to a Copado AI workspace

```
USAGE
  $ agentia ai workspace member invite WORKSPACE --permission Access|Manage --user-id <value> [--json] [--timeout
  <value>]

ARGUMENTS
  WORKSPACE  Copado AI workspace UUID.

FLAGS
  --permission=<option>  (required) Workspace permission for the invited member.
                         <options: Access|Manage>
  --timeout=<value>      AI gateway timeout in seconds.
  --user-id=<value>      (required) Copado AI user ID to invite.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Invite a member to a Copado AI workspace

EXAMPLES
  $ agentia ai workspace member invite 42d0b908-37b7-4565-9ec9-86eda40c9782 --user-id 12345 --permission Access

  $ agentia ai workspace member invite 42d0b908-37b7-4565-9ec9-86eda40c9782 --user-id 12345 --permission Manage --json
```

_See code: [src/commands/ai/workspace/member/invite.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/ai/workspace/member/invite.ts)_

## `agentia ai workspace member list WORKSPACE`

List members for a Copado AI workspace

```
USAGE
  $ agentia ai workspace member list WORKSPACE [--json] [--timeout <value>]

ARGUMENTS
  WORKSPACE  Copado AI workspace UUID.

FLAGS
  --timeout=<value>  AI gateway timeout in seconds.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List members for a Copado AI workspace

EXAMPLES
  $ agentia ai workspace member list 42d0b908-37b7-4565-9ec9-86eda40c9782

  $ agentia ai workspace member list 42d0b908-37b7-4565-9ec9-86eda40c9782 --json
```

_See code: [src/commands/ai/workspace/member/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/ai/workspace/member/list.ts)_

## `agentia ai workspace update ID`

Update a Copado AI workspace

```
USAGE
  $ agentia ai workspace update ID [--json] [--timeout <value>] [--capability
    AgentFramework|Artifacts|CRTKnowledge|CustomKnowledge|DeepResearch|EssentialsKnowledge|LongTermMemory|Mermaid|Metada
    taFormatKnowledge|Mindmap|OtherKnowledge|Reasoning|SourceFormatKnowledge|STEM|TabularData|WebSearch...]
    [--default-dataset-id <value>] [--description <value>] [--name <value>]

ARGUMENTS
  ID  Copado AI workspace UUID.

FLAGS
  --capability=<option>...      Workspace capability. Can be provided multiple times and replaces the existing set when
                                provided.
                                <options: AgentFramework|Artifacts|CRTKnowledge|CustomKnowledge|DeepResearch|EssentialsK
                                nowledge|LongTermMemory|Mermaid|MetadataFormatKnowledge|Mindmap|OtherKnowledge|Reasoning
                                |SourceFormatKnowledge|STEM|TabularData|WebSearch>
  --default-dataset-id=<value>  Default dataset UUID for the workspace.
  --description=<value>         Workspace description.
  --name=<value>                Workspace name.
  --timeout=<value>             AI gateway timeout in seconds.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado AI workspace

EXAMPLES
  $ agentia ai workspace update 42d0b908-37b7-4565-9ec9-86eda40c9782 --name "Delivery Workspace"

  $ agentia ai workspace update 42d0b908-37b7-4565-9ec9-86eda40c9782 --capability Reasoning --capability CustomKnowledge
```

_See code: [src/commands/ai/workspace/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/ai/workspace/update.ts)_

## `agentia auth get`

Show stored authentication credentials and their configured endpoints and scopes

```
USAGE
  $ agentia auth get [--json] [--adv] [--ai] [--cicd] [--crt]

FLAGS
  --adv   Show PAT for Pipelines Advanced authentication
  --ai    Show PAK for Copado AI authentication
  --cicd  Show Copado API key for CICD authentication
  --crt   Show PAK for CRT authentication

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show stored authentication credentials and their configured endpoints and scopes

EXAMPLES
  $ agentia auth get

  $ agentia auth get --ai

  $ agentia auth get --adv

  $ agentia auth get --cicd

  $ agentia auth get --crt

  $ agentia auth get --cicd --crt

  $ agentia auth get --json
```

_See code: [src/commands/auth/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/auth/get.ts)_

## `agentia auth set`

Store authentication credentials securely in the system keychain

```
USAGE
  $ agentia auth set [--json] [--adv <value>] [--adv-base-url <value>] [--ai <value>] [--ai-domain <value>]
    [--ai-gateway-url <value>] [--ai-org <value>] [--ai-workspace <value>] [--cicd <value>] [--crt <value>]
    [--crt-domain <value>] [--crt-org <value>] [--custom-url <value>] [--local] [--region na|emea|emea2|apac|apac2]

FLAGS
  --adv=<value>             Personal Access Token for Copado Pipelines Advanced authentication
  --adv-base-url=<value>    Optional Pipelines Advanced base URL; omit to auto-discover from the PAT
  --ai=<value>              PAK for Copado AI authentication
  --ai-domain=<value>       Optional Copado AI domain hostname; omit to auto-discover from the PAK and organization ID
  --ai-gateway-url=<value>  Full Copado AI gateway base URL used instead of deriving from domain and organization; HTTP
                            is allowed for local testing
  --ai-org=<value>          Copado AI organization ID used with --ai-domain
  --ai-workspace=<value>    Copado AI workspace UUID to validate and store as the default
  --cicd=<value>            Copado API key for CICD authentication
  --crt=<value>             PAK for CRT authentication (requires --crt-org)
  --crt-domain=<value>      CRT domain hostname for robotic testing commands
  --crt-org=<value>         CRT organization ID for robotic testing commands
  --custom-url=<value>      CICD gateway base URL used instead of regional mapping
  --local                   Store authentication for the current project and user.
  --region=<option>         CICD region used to resolve the gateway endpoint
                            <options: na|emea|emea2|apac|apac2>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Store authentication credentials securely in the system keychain

EXAMPLES
  $ agentia auth set --ai <pak> --ai-domain robotic.copado.com --ai-org 42888

  $ agentia auth set --ai <pak> --ai-org 42888

  $ agentia auth set --ai <pak> --ai-domain robotic.copado.com --ai-org 42888 --ai-workspace 42d0b908-37b7-4565-9ec9-86eda40c9782

  $ agentia auth set --ai <pak> --ai-gateway-url http://localhost:8080/organizations/42888

  $ agentia auth set --ai-workspace 42d0b908-37b7-4565-9ec9-86eda40c9782

  $ agentia auth set --adv <pat>

  $ agentia auth set --adv <pat> --adv-base-url https://uat.pipeline.copado.com

  $ agentia auth set --cicd <copado-api-key> --region na

  $ agentia auth set --cicd <copado-api-key> --custom-url https://dev.api.copado.com

  $ agentia auth set --cicd <copado-api-key>

  $ agentia auth set --crt <pak> --crt-org <crt-org-id>

  $ agentia auth set --crt <pak> --crt-domain robotic.copado.com --crt-org <crt-org-id>

  $ agentia auth set --cicd <copado-api-key> --region na --crt <pak>

  $ agentia auth set --cicd <copado-api-key> --region na --json
```

_See code: [src/commands/auth/set.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/auth/set.ts)_

## `agentia auth unset`

Remove stored authentication credentials from the system keychain

```
USAGE
  $ agentia auth unset [--json] [--adv] [--ai] [--cicd] [--crt] [--global] [--local] [-y]

FLAGS
  -y, --yes     Confirm removal without prompting (required for --json)
      --adv     Remove Pipelines Advanced PAT and endpoint configuration
      --ai      Remove Copado AI PAK, domain, organization, workspace, and gateway URL configuration
      --cicd    Remove Copado API key and CICD endpoint configuration
      --crt     Remove CRT PAK, domain, and organization configuration
      --global  Remove global authentication (the default scope).
      --local   Remove authentication for the current project and user.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Remove stored authentication credentials from the system keychain

EXAMPLES
  $ agentia auth unset

  $ agentia auth unset --ai

  $ agentia auth unset --adv

  $ agentia auth unset --cicd

  $ agentia auth unset --crt

  $ agentia auth unset --cicd --crt --yes

  $ agentia auth unset --json --yes
```

_See code: [src/commands/auth/unset.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/auth/unset.ts)_

## `agentia cicd cloud commit [ID]`

Create a Copado cloud metadata commit for a user story.

```
USAGE
  $ agentia cicd cloud commit [ID] [--json] [--action Add|Delete|RetrieveOnly|SelectiveCommit|Full] [--base-branch
    <value>] [--commit-id <value>] [--execute-commit] [-f <value>] [-m <value>] [--metadata-category <value>]
    [--metadata-message <value>] [--metadata-name <value>] [--metadata-raw-json <value>] [--metadata-type <value>]
    [--recreate-feature-branch] [--selection <value>...] [--stdin] [--wait] [--wait-timeout <value>]

ARGUMENTS
  [ID]  User story ID (defaults to the active work item from `work set`)

FLAGS
  -f, --file=<value>               Path to a JSON commit request body.
  -m, --message=<value>            Commit message. Required unless provided by JSON input.
      --action=<option>            Metadata action for simple flag input. Defaults to Add.
                                   <options: Add|Delete|RetrieveOnly|SelectiveCommit|Full>
      --base-branch=<value>        Optional base branch to include in the commit request.
      --commit-id=<value>          Existing local Git commit identifier to register when --no-execute-commit is used.
      --[no-]execute-commit        Execute the Copado commit job. Use --no-execute-commit only with --commit-id.
      --metadata-category=<value>  Required metadata category for simple input. Maps to change field c. For Salesforce
                                   metadata, set SFDX so Copado stores c:SFDX. Without c:SFDX, SFDX deploy steps log
                                   "Salesforce changes not found." and skip the deploy while the job can still report
                                   Successful.
      --metadata-message=<value>   Optional per-change message for simple flag input.
      --metadata-name=<value>      Metadata full name for simple flag input.
      --metadata-raw-json=<value>  Optional raw metadata JSON value for simple flag input.
      --metadata-type=<value>      Metadata type for simple flag input, for example ApexClass.
      --recreate-feature-branch    Ask Copado to recreate the feature branch before committing.
      --selection=<value>...       Selected file inside a bundle for SelectiveCommit. Can be provided multiple times.
      --stdin                      Read a JSON commit request body from stdin.
      --[no-]wait                  Poll the commit job to a terminal status when a jobExecution Id is returned.
      --wait-timeout=<value>       [default: 300] Maximum seconds to wait for the commit job.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado cloud metadata commit for a user story.
  Preflights the story, submits POST /release/commit, and polls the job monitor by default.
  For local Git work, use git add/commit then `cicd work publish`. Permission and full-metadata selections belong on
  `cicd work publish`.

  NOTE: Do not use this command along with local development (git operations, cicd work push/submit).

EXAMPLES
  $ agentia cicd cloud commit --message "Commit AccountService" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add

  $ agentia cicd cloud commit a07XXXXXXXXXXXXXXX --message "Update Aura files" --metadata-name accountEditor --metadata-type AuraDefinitionBundle --metadata-category SFDX --action SelectiveCommit --selection accountEditor/accountEditor.cmp --selection accountEditor/accountEditorController.js

  $ agentia cicd cloud commit --file commit-request.json  # {"message":"Commit AccountService","changes":[{"a":"Add","c":"SFDX","n":"AccountService","t":"ApexClass"}]}

  cat commit-request.json | agentia cicd cloud commit --stdin --json
```

_See code: [src/commands/cicd/cloud/commit.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/cloud/commit.ts)_

## `agentia cicd cloud promote [ID]`

Promote the explicit or active User Story through its Copado Promotion. Selects promote-only unless --deploy is passed.

```
USAGE
  $ agentia cicd cloud promote [ID] [--json] [--deploy] [--deployment-step-id <value>...] [--ignored-metadata-json
    <value>] [--promotion-id <value>] [--recreate-promotion-branch] [--wait] [--wait-timeout <value>] [-y]

ARGUMENTS
  [ID]  User Story ID (defaults to the active work item from `work set`)

FLAGS
  -y, --yes                            Confirm promotion branch recreation without prompting.
      --deploy                         Use merge_and_deploy instead of promote-only merge.
      --deployment-step-id=<value>...  Ordered deployment-step Salesforce ID. Can be provided multiple times with
                                       --deploy.
      --ignored-metadata-json=<value>  JSON array to persist through ignored-metadata before starting the promotion.
      --promotion-id=<value>           Explicit 18-character Promotion ID when the User Story belongs to multiple
                                       promotions.
      --recreate-promotion-branch      Recreate the promotion branch before execution. Requires confirmation or --yes.
      --[no-]wait                      Poll promotion and deployment executions to terminal status.
      --wait-timeout=<value>           [default: 900] Maximum total seconds to wait for promotion and deployment
                                       executions.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Promote the explicit or active User Story through its Copado Promotion. Selects promote-only unless --deploy is
  passed.

EXAMPLES
  $ agentia cicd cloud promote

  $ agentia cicd cloud promote a07XXXXXXXXXXXXXXX --promotion-id a0BXXXXXXXXXXXXXXX

  $ agentia cicd cloud promote --deploy --json
```

_See code: [src/commands/cicd/cloud/promote.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/cloud/promote.ts)_

## `agentia cicd credential auth status ID`

Validate the authentication status of a credential by ID

```
USAGE
  $ agentia cicd credential auth status ID [--json]

ARGUMENTS
  ID  Copado credential ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Validate the authentication status of a credential by ID

EXAMPLES
  $ agentia cicd credential auth status <credential-id>

  $ agentia cicd credential auth status <credential-id> --json
```

_See code: [src/commands/cicd/credential/auth/status.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/credential/auth/status.ts)_

## `agentia cicd credential auth web login ID`

Authenticate a credential via browser web login

```
USAGE
  $ agentia cicd credential auth web login ID [--json] [--port <value>] [--timeout <value>]

ARGUMENTS
  ID  Copado credential ID

FLAGS
  --port=<value>     Local loopback port (default: scan 8080-8090)
  --timeout=<value>  [default: 300] Max seconds to wait for browser login

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Authenticate a credential via browser web login

EXAMPLES
  $ agentia cicd credential auth web login <credential-id>

  $ agentia cicd credential auth web login <credential-id> --port 8085 --timeout 120

  $ agentia cicd credential auth web login <credential-id> --json
```

_See code: [src/commands/cicd/credential/auth/web/login.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/credential/auth/web/login.ts)_

## `agentia cicd credential create`

Create a Copado environment credential

```
USAGE
  $ agentia cicd credential create --environmentid <value> --name <value> [--json] [--default]

FLAGS
  --[no-]default           Mark this credential as the environment default
  --environmentid=<value>  (required) Copado environment ID
  --name=<value>           (required) Credential name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado environment credential

EXAMPLES
  $ agentia cicd credential create --environmentid <environment-id> --name "CI User"

  $ agentia cicd credential create --environmentid <environment-id> --name "CI User" --default

  $ agentia cicd credential create --environmentid <environment-id> --name "CI User" --json
```

_See code: [src/commands/cicd/credential/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/credential/create.ts)_

## `agentia cicd credential list`

List Copado credentials across environments

```
USAGE
  $ agentia cicd credential list [--json] [--cursor <value>] [--page-size <value>] [--name <value>]

FLAGS
  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
  --name=<value>       Filter credentials by name (partial match)
  --page-size=<value>  Number of records per page (1-200)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado credentials across environments

EXAMPLES
  $ agentia cicd credential list

  $ agentia cicd credential list --name CI

  $ agentia cicd credential list --page-size 50

  $ agentia cicd credential list --cursor NEXT --json
```

_See code: [src/commands/cicd/credential/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/credential/list.ts)_

## `agentia cicd credential open ID`

Open a Copado credential in the browser

```
USAGE
  $ agentia cicd credential open ID [--json]

ARGUMENTS
  ID  Copado credential ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado credential in the browser

EXAMPLES
  $ agentia cicd credential open <credential-id>

  $ agentia cicd credential open <credential-id> --json
```

_See code: [src/commands/cicd/credential/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/credential/open.ts)_

## `agentia cicd credential update ID`

Update a Copado credential by ID

```
USAGE
  $ agentia cicd credential update ID [--json] [--default] [--name <value>]

ARGUMENTS
  ID  Copado credential ID

FLAGS
  --[no-]default  Mark this credential as the environment default
  --name=<value>  Credential name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado credential by ID

EXAMPLES
  $ agentia cicd credential update <credential-id> --name "CI User"

  $ agentia cicd credential update <credential-id> --default

  $ agentia cicd credential update <credential-id> --no-default --json
```

_See code: [src/commands/cicd/credential/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/credential/update.ts)_

## `agentia cicd data commit create`

Create a data commit for a user story

```
USAGE
  $ agentia cicd data commit create [--json] [-f <value> | --stdin]

FLAGS
  -f, --file=<value>  Path to a JSON file body
      --stdin         Read the JSON body from stdin

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a data commit for a user story

EXAMPLES
  $ agentia cicd data commit create --file commit.json

  $ agentia cicd data commit create --stdin --json
```

_See code: [src/commands/cicd/data/commit/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/commit/create.ts)_

## `agentia cicd data commit list USERSTORYID`

List data commits for a user story

```
USAGE
  $ agentia cicd data commit list USERSTORYID [--json]

ARGUMENTS
  USERSTORYID  User story Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List data commits for a user story

EXAMPLES
  $ agentia cicd data commit list a16P7000006AyU5IAK

  $ agentia cicd data commit list a16P7000006AyU5IAK --json
```

_See code: [src/commands/cicd/data/commit/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/commit/list.ts)_

## `agentia cicd data dataset-file content CONTENTVERSIONID`

Get dataset file content by ContentVersion Id

```
USAGE
  $ agentia cicd data dataset-file content CONTENTVERSIONID [--json]

ARGUMENTS
  CONTENTVERSIONID  ContentVersion Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get dataset file content by ContentVersion Id

EXAMPLES
  $ agentia cicd data dataset-file content 068000000000001

  $ agentia cicd data dataset-file content 068000000000001 --json
```

_See code: [src/commands/cicd/data/dataset-file/content.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/dataset-file/content.ts)_

## `agentia cicd data dataset-file list USERSTORYDATACOMMITID`

List dataset files for a user story data commit

```
USAGE
  $ agentia cicd data dataset-file list USERSTORYDATACOMMITID [--json]

ARGUMENTS
  USERSTORYDATACOMMITID  User story data commit Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List dataset files for a user story data commit

EXAMPLES
  $ agentia cicd data dataset-file list a1A000000000001

  $ agentia cicd data dataset-file list a1A000000000001 --json
```

_See code: [src/commands/cicd/data/dataset-file/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/dataset-file/list.ts)_

## `agentia cicd data filter add DATATEMPLATEID`

Add an advanced filter to a data template

```
USAGE
  $ agentia cicd data filter add DATATEMPLATEID [--json] [-f <value> | --stdin]

ARGUMENTS
  DATATEMPLATEID  Data template Id

FLAGS
  -f, --file=<value>  Path to a JSON file body
      --stdin         Read the JSON body from stdin

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Add an advanced filter to a data template

EXAMPLES
  $ agentia cicd data filter add a0X000000000001 --file filter.json

  $ agentia cicd data filter add a0X000000000001 --stdin --json
```

_See code: [src/commands/cicd/data/filter/add.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/filter/add.ts)_

## `agentia cicd data filter delete DATATEMPLATEID UUID`

Delete an advanced filter from a data template

```
USAGE
  $ agentia cicd data filter delete DATATEMPLATEID UUID [--json]

ARGUMENTS
  DATATEMPLATEID  Data template Id
  UUID            Advanced filter UUID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete an advanced filter from a data template

EXAMPLES
  $ agentia cicd data filter delete a0X000000000001 550e8400-e29b-41d4-a716-446655440000

  $ agentia cicd data filter delete a0X000000000001 550e8400-e29b-41d4-a716-446655440000 --json
```

_See code: [src/commands/cicd/data/filter/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/filter/delete.ts)_

## `agentia cicd data filter list DATATEMPLATEID`

List advanced filters for a data template

```
USAGE
  $ agentia cicd data filter list DATATEMPLATEID [--json]

ARGUMENTS
  DATATEMPLATEID  Data template Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List advanced filters for a data template

EXAMPLES
  $ agentia cicd data filter list a0X000000000001

  $ agentia cicd data filter list a0X000000000001 --json
```

_See code: [src/commands/cicd/data/filter/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/filter/list.ts)_

## `agentia cicd data filter update DATATEMPLATEID UUID`

Update an advanced filter on a data template

```
USAGE
  $ agentia cicd data filter update DATATEMPLATEID UUID [--json] [-f <value> | --stdin]

ARGUMENTS
  DATATEMPLATEID  Data template Id
  UUID            Advanced filter UUID

FLAGS
  -f, --file=<value>  Path to a JSON file body
      --stdin         Read the JSON body from stdin

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update an advanced filter on a data template

EXAMPLES
  $ agentia cicd data filter update a0X000000000001 550e8400-e29b-41d4-a716-446655440000 --file filter.json

  $ agentia cicd data filter update a0X000000000001 550e8400-e29b-41d4-a716-446655440000 --stdin --json
```

_See code: [src/commands/cicd/data/filter/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/filter/update.ts)_

## `agentia cicd data formula create DATATEMPLATEID`

Create a record matching formula for a data template

```
USAGE
  $ agentia cicd data formula create DATATEMPLATEID --fields <value>... --name <value> --object-api-name <value> [--json]
    [--hash-formula]

ARGUMENTS
  DATATEMPLATEID  Data template Id

FLAGS
  --fields=<value>...        (required) Formula fields (repeatable or comma-separated, up to 3)
  --hash-formula             Enable hash formula
  --name=<value>             (required) Formula name
  --object-api-name=<value>  (required) sObject API name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a record matching formula for a data template

EXAMPLES
  $ agentia cicd data formula create a0X... --name MatchByName --object-api-name Account --fields Name,BillingCity

  $ agentia cicd data formula create a0X... --name MatchByName --object-api-name Account --fields Name --fields BillingCity --hash-formula --json
```

_See code: [src/commands/cicd/data/formula/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/formula/create.ts)_

## `agentia cicd data formula list OBJECTAPINAME`

List record matching formulas for an sObject

```
USAGE
  $ agentia cicd data formula list OBJECTAPINAME [--json]

ARGUMENTS
  OBJECTAPINAME  sObject API name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List record matching formulas for an sObject

EXAMPLES
  $ agentia cicd data formula list Account

  $ agentia cicd data formula list Account --json
```

_See code: [src/commands/cicd/data/formula/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/formula/list.ts)_

## `agentia cicd data formula update FORMULAID`

Update a record matching formula

```
USAGE
  $ agentia cicd data formula update FORMULAID [--json] [--fields <value>...] [--hash-formula] [--name <value>]
    [--object-api-name <value>] [-f <value> | --stdin]

ARGUMENTS
  FORMULAID  Record matching formula Id

FLAGS
  -f, --file=<value>             Path to a JSON file body
      --fields=<value>...        Formula fields (repeatable or comma-separated, up to 3)
      --[no-]hash-formula        Enable or disable hash formula
      --name=<value>             Formula name
      --object-api-name=<value>  sObject API name
      --stdin                    Read the JSON body from stdin

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a record matching formula

EXAMPLES
  $ agentia cicd data formula update a0F... --name MatchByName --object-api-name Account --fields Name,BillingCity

  $ agentia cicd data formula update a0F... --file formula.json

  $ agentia cicd data formula update a0F... --stdin --json
```

_See code: [src/commands/cicd/data/formula/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/formula/update.ts)_

## `agentia cicd data records match`

Match a source data record to a destination org

```
USAGE
  $ agentia cicd data records match [--json] [-f <value> | --stdin]

FLAGS
  -f, --file=<value>  Path to a JSON file body
      --stdin         Read the JSON body from stdin

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Match a source data record to a destination org

EXAMPLES
  $ agentia cicd data records match --file match.json

  $ agentia cicd data records match --stdin --json
```

_See code: [src/commands/cicd/data/records/match.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/records/match.ts)_

## `agentia cicd data records search`

Search data records for a data template

```
USAGE
  $ agentia cicd data records search --credential-id <value> --data-template-id <value> [--json] [--changed-date-from <value>]
    [-f <value> | --stdin]

FLAGS
  -f, --file=<value>               Path to a JSON file body
      --changed-date-from=<value>  Optional changed-date-from filter (ISO datetime)
      --credential-id=<value>      (required) Org credential Id
      --data-template-id=<value>   (required) Data template Id
      --stdin                      Read the JSON body from stdin

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Search data records for a data template

EXAMPLES
  $ agentia cicd data records search --credential-id a0Y... --data-template-id a0X...

  $ agentia cicd data records search --credential-id a0Y... --data-template-id a0X... --file request.json

  $ agentia cicd data records search --credential-id a0Y... --data-template-id a0X... --json
```

_See code: [src/commands/cicd/data/records/search.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/records/search.ts)_

## `agentia cicd data sobject fields SOBJECTAPINAME`

Describe fields for an sObject via a credential

```
USAGE
  $ agentia cicd data sobject fields SOBJECTAPINAME --credential-id <value> [--json]

ARGUMENTS
  SOBJECTAPINAME  sObject API name

FLAGS
  --credential-id=<value>  (required) Org credential Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Describe fields for an sObject via a credential

EXAMPLES
  $ agentia cicd data sobject fields Account --credential-id a0Y...

  $ agentia cicd data sobject fields Account --credential-id a0Y... --json
```

_See code: [src/commands/cicd/data/sobject/fields.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/sobject/fields.ts)_

## `agentia cicd data sobject relationships SOBJECTAPINAME`

Describe relationships for an sObject via a credential

```
USAGE
  $ agentia cicd data sobject relationships SOBJECTAPINAME --credential-id <value> [--json]

ARGUMENTS
  SOBJECTAPINAME  sObject API name

FLAGS
  --credential-id=<value>  (required) Org credential Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Describe relationships for an sObject via a credential

EXAMPLES
  $ agentia cicd data sobject relationships Account --credential-id a0Y...

  $ agentia cicd data sobject relationships Account --credential-id a0Y... --json
```

_See code: [src/commands/cicd/data/sobject/relationships.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/sobject/relationships.ts)_

## `agentia cicd data sync apply`

Apply data template field sync entries

```
USAGE
  $ agentia cicd data sync apply [--json] [-f <value> | --stdin]

FLAGS
  -f, --file=<value>  Path to a JSON file body
      --stdin         Read the JSON body from stdin

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Apply data template field sync entries

EXAMPLES
  $ agentia cicd data sync apply --file sync.json

  $ agentia cicd data sync apply --stdin --json
```

_See code: [src/commands/cicd/data/sync/apply.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/sync/apply.ts)_

## `agentia cicd data sync preview-updates`

Preview data template updates from metadata commit changes

```
USAGE
  $ agentia cicd data sync preview-updates [--json] [-f <value> | --stdin]

FLAGS
  -f, --file=<value>  Path to a JSON file body
      --stdin         Read the JSON body from stdin

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Preview data template updates from metadata commit changes

EXAMPLES
  $ agentia cicd data sync preview-updates --file preview.json

  $ agentia cicd data sync preview-updates --stdin --json
```

_See code: [src/commands/cicd/data/sync/preview-updates.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/sync/preview-updates.ts)_

## `agentia cicd data template convert-old ID`

Convert a legacy data template graph to v2

```
USAGE
  $ agentia cicd data template convert-old ID [--json]

ARGUMENTS
  ID  Legacy data template Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Convert a legacy data template graph to v2

EXAMPLES
  $ agentia cicd data template convert-old a0X000000000001

  $ agentia cicd data template convert-old a0X000000000001 --json
```

_See code: [src/commands/cicd/data/template/convert-old.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/template/convert-old.ts)_

## `agentia cicd data template create`

Create a Copado data template

```
USAGE
  $ agentia cicd data template create --api-name <value> --credential-id <value> --main-object-api-name <value>
    --main-object-label <value> --template-name <value> [--json]

FLAGS
  --api-name=<value>              (required) Template API name
  --credential-id=<value>         (required) Org credential Id
  --main-object-api-name=<value>  (required) Main sObject API name
  --main-object-label=<value>     (required) Main sObject label
  --template-name=<value>         (required) Template display name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado data template

EXAMPLES
  $ agentia cicd data template create --credential-id a0Y... --template-name Accounts --api-name Accounts --main-object-api-name Account --main-object-label Account

  $ agentia cicd data template create --credential-id a0Y... --template-name Accounts --api-name Accounts --main-object-api-name Account --main-object-label Account --json
```

_See code: [src/commands/cicd/data/template/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/template/create.ts)_

## `agentia cicd data template delete ID`

Delete a Copado data template

```
USAGE
  $ agentia cicd data template delete ID [--json]

ARGUMENTS
  ID  Data template Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado data template

EXAMPLES
  $ agentia cicd data template delete a0X000000000001

  $ agentia cicd data template delete a0X000000000001 --json
```

_See code: [src/commands/cicd/data/template/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/template/delete.ts)_

## `agentia cicd data template get ID`

Get a data template export graph (selected columns only)

```
USAGE
  $ agentia cicd data template get ID [--json]

ARGUMENTS
  ID  Data template Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a data template export graph (selected columns only)

EXAMPLES
  $ agentia cicd data template get a0X000000000001

  $ agentia cicd data template get a0X000000000001 --json
```

_See code: [src/commands/cicd/data/template/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/template/get.ts)_

## `agentia cicd data template get-detail ID`

Get the raw v2 data template detail payload

```
USAGE
  $ agentia cicd data template get-detail ID [--json]

ARGUMENTS
  ID  Data template Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get the raw v2 data template detail payload

EXAMPLES
  $ agentia cicd data template get-detail a0X000000000001

  $ agentia cicd data template get-detail a0X000000000001 --json
```

_See code: [src/commands/cicd/data/template/get-detail.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/template/get-detail.ts)_

## `agentia cicd data template list`

List Copado data templates

```
USAGE
  $ agentia cicd data template list [--json] [--active] [--fetch-related] [--main-object <value>] [--name <value>]

FLAGS
  --[no-]active          Filter by active flag (--active / --no-active)
  --fetch-related        Include related template information
  --main-object=<value>  Filter by main sObject API name
  --name=<value>         Filter by name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado data templates

EXAMPLES
  $ agentia cicd data template list

  $ agentia cicd data template list --fetch-related --active

  $ agentia cicd data template list --no-active --json

  $ agentia cicd data template list --name Accounts --main-object Account
```

_See code: [src/commands/cicd/data/template/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/template/list.ts)_

## `agentia cicd data template open ID`

Open a Copado data template in the browser

```
USAGE
  $ agentia cicd data template open ID [--json]

ARGUMENTS
  ID  Data template Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado data template in the browser

EXAMPLES
  $ agentia cicd data template open a0X000000000001

  $ agentia cicd data template open a0X000000000001 --json
```

_See code: [src/commands/cicd/data/template/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/template/open.ts)_

## `agentia cicd data template save-detail ID`

Save a v2 data template detail payload

```
USAGE
  $ agentia cicd data template save-detail ID [--json] [-f <value> | --stdin]

ARGUMENTS
  ID  Data template Id

FLAGS
  -f, --file=<value>  Path to a JSON file body
      --stdin         Read the JSON body from stdin

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Save a v2 data template detail payload

EXAMPLES
  $ agentia cicd data template save-detail a0X000000000001 --file detail.json

  $ agentia cicd data template save-detail a0X000000000001 --stdin --json
```

_See code: [src/commands/cicd/data/template/save-detail.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/data/template/save-detail.ts)_

## `agentia cicd environment auth status [ID]`

Validate the authentication status of an environment credential

```
USAGE
  $ agentia cicd environment auth status [ID] [--json] [--credentialid <value>]

ARGUMENTS
  [ID]  Copado environment ID (optional when --credentialid is provided)

FLAGS
  --credentialid=<value>  Credential ID to validate; when set without an environment ID, resolves the environment from
                          the credential

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Validate the authentication status of an environment credential

EXAMPLES
  $ agentia cicd environment auth status <environment-id>

  $ agentia cicd environment auth status --credentialid <credential-id>

  $ agentia cicd environment auth status <environment-id> --json
```

_See code: [src/commands/cicd/environment/auth/status.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/environment/auth/status.ts)_

## `agentia cicd environment auth web login [ID]`

Authenticate an environment credential via browser web login

```
USAGE
  $ agentia cicd environment auth web login [ID] [--json] [--credentialid <value>] [--port <value>] [--timeout <value>]

ARGUMENTS
  [ID]  Copado environment ID (optional when --credentialid is provided)

FLAGS
  --credentialid=<value>  Credential ID to authenticate; when set without an environment ID, resolves the environment
                          from the credential
  --port=<value>          Local loopback port (default: scan 8080-8090)
  --timeout=<value>       [default: 300] Max seconds to wait for browser login

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Authenticate an environment credential via browser web login

EXAMPLES
  $ agentia cicd environment auth web login <environment-id>

  $ agentia cicd environment auth web login --credentialid <credential-id>

  $ agentia cicd environment auth web login <environment-id> --port 8085 --timeout 120

  $ agentia cicd environment auth web login <environment-id> --json
```

_See code: [src/commands/cicd/environment/auth/web/login.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/environment/auth/web/login.ts)_

## `agentia cicd environment create NAME`

Create a Copado environment

```
USAGE
  $ agentia cicd environment create NAME [--json] [--enable-rollback] [--index-back-promotion-metadata] [--run-local-tests]
    [--apex-test-level <value>] [--namespace <value>] [--promotion-default-credential <value>] [--run-specified-tests
    <value>] [--validation-promotion-default-credential <value>] [--platform <value>] [--type
    Production/Developer|Sandbox|Scratch Org|Custom Domain]

ARGUMENTS
  NAME  Name of the environment to create

FLAGS
  --apex-test-level=<value>                          Apex test level
  --[no-]enable-rollback                             Enable rollback
  --[no-]index-back-promotion-metadata               Index back promotion metadata
  --namespace=<value>                                Environment namespace
  --platform=<value>                                 [default: SFDX] Environment platform
  --promotion-default-credential=<value>             Default credential for promotions
  --[no-]run-local-tests                             Run local tests
  --run-specified-tests=<value>                      Specified tests to run
  --type=<option>                                    [default: Production/Developer] Environment type
                                                     <options: Production/Developer|Sandbox|Scratch Org|Custom Domain>
  --validation-promotion-default-credential=<value>  Default credential for validation promotions

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado environment

EXAMPLES
  $ agentia cicd environment create Dev

  $ agentia cicd environment create Dev --type Sandbox --platform SFDX

  $ agentia cicd environment create Dev --run-local-tests --apex-test-level "No Test Run"

  $ agentia cicd environment create Dev --json
```

_See code: [src/commands/cicd/environment/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/environment/create.ts)_

## `agentia cicd environment get ID`

Get a Copado environment by ID

```
USAGE
  $ agentia cicd environment get ID [--json]

ARGUMENTS
  ID  Copado environment ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado environment by ID

EXAMPLES
  $ agentia cicd environment get a0SKC000000CmZ2AU

  $ agentia cicd environment get a0SKC000000CmZ2AU --json
```

_See code: [src/commands/cicd/environment/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/environment/get.ts)_

## `agentia cicd environment list`

List Copado environments

```
USAGE
  $ agentia cicd environment list [--json] [--cursor <value>] [--page-size <value>] [--name <value>] [--org-id <value>]
    [--platform <value>] [--type Production/Developer|Sandbox|Scratch Org|Custom Domain]

FLAGS
  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
  --name=<value>       Filter by name
  --org-id=<value>     Filter by Salesforce org ID
  --page-size=<value>  Number of records per page (1-200)
  --platform=<value>   Filter by platform
  --type=<option>      Environment type
                       <options: Production/Developer|Sandbox|Scratch Org|Custom Domain>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado environments

EXAMPLES
  $ agentia cicd environment list

  $ agentia cicd environment list --name Dev --org-id 00D000000000000 --platform SFDX --type Sandbox

  $ agentia cicd environment list --json
```

_See code: [src/commands/cicd/environment/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/environment/list.ts)_

## `agentia cicd environment open [ID]`

Open a Copado environment in the browser

```
USAGE
  $ agentia cicd environment open [ID] [--json]

ARGUMENTS
  [ID]  Copado environment ID (defaults to the configured project default environment)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado environment in the browser

EXAMPLES
  $ agentia cicd environment open

  $ agentia cicd environment open a0SKC000000CmZ2AU

  $ agentia cicd environment open a0SKC000000CmZ2AU --json
```

_See code: [src/commands/cicd/environment/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/environment/open.ts)_

## `agentia cicd environment update ID`

Update a Copado environment by ID

```
USAGE
  $ agentia cicd environment update ID [--json] [--enable-rollback] [--index-back-promotion-metadata] [--run-local-tests]
    [--apex-test-level <value>] [--name <value>] [--namespace <value>] [--platform <value>]
    [--promotion-default-credential <value>] [--run-specified-tests <value>] [--type
    Production/Developer|Sandbox|Scratch Org|Custom Domain] [--validation-promotion-default-credential <value>]

ARGUMENTS
  ID  Copado environment ID

FLAGS
  --apex-test-level=<value>                          Apex test level
  --[no-]enable-rollback                             Enable rollback
  --[no-]index-back-promotion-metadata               Index back promotion metadata
  --name=<value>                                     Environment name
  --namespace=<value>                                Environment namespace
  --platform=<value>                                 Environment platform
  --promotion-default-credential=<value>             Default credential for promotions
  --[no-]run-local-tests                             Run local tests
  --run-specified-tests=<value>                      Specified tests to run
  --type=<option>                                    Environment type
                                                     <options: Production/Developer|Sandbox|Scratch Org|Custom Domain>
  --validation-promotion-default-credential=<value>  Default credential for validation promotions

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado environment by ID

EXAMPLES
  $ agentia cicd environment update a0SKC000000CmZ2AU --name UAT

  $ agentia cicd environment update a0SKC000000CmZ2AU --type Sandbox --enable-rollback

  $ agentia cicd environment update a0SKC000000CmZ2AU --no-run-local-tests

  $ agentia cicd environment update a0SKC000000CmZ2AU --name UAT --json
```

_See code: [src/commands/cicd/environment/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/environment/update.ts)_

## `agentia cicd extension-configuration get ID`

Get a Copado extension configuration

```
USAGE
  $ agentia cicd extension-configuration get ID [--json]

ARGUMENTS
  ID  Extension configuration ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado extension configuration

EXAMPLES
  $ agentia cicd extension-configuration get <configuration-id>

  $ agentia cicd extension-configuration get <configuration-id> --json
```

_See code: [src/commands/cicd/extension-configuration/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/extension-configuration/get.ts)_

## `agentia cicd extension-configuration list`

List Copado extension configurations

```
USAGE
  $ agentia cicd extension-configuration list [--json] [--cursor <value>] [--page-size <value>] [--active] [--name <value>]
    [--test-type <value>] [--tool <value>]

FLAGS
  --[no-]active        Filter by active status
  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
  --name=<value>       Filter by extension configuration name
  --page-size=<value>  Number of records per page (1-200)
  --test-type=<value>  Filter by test type
  --tool=<value>       Filter by extension tool

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado extension configurations

EXAMPLES
  $ agentia cicd extension-configuration list

  $ agentia cicd extension-configuration list --tool Selenium --active --json
```

_See code: [src/commands/cicd/extension-configuration/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/extension-configuration/list.ts)_

## `agentia cicd extension-configuration open ID`

Open a Copado extension configuration in the browser

```
USAGE
  $ agentia cicd extension-configuration open ID [--json]

ARGUMENTS
  ID  Extension configuration Salesforce ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado extension configuration in the browser

EXAMPLES
  $ agentia cicd extension-configuration open <configuration-id>

  $ agentia cicd extension-configuration open <configuration-id> --json
```

_See code: [src/commands/cicd/extension-configuration/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/extension-configuration/open.ts)_

## `agentia cicd extension create`

Create or refresh a Copado extension manifest at copado/extension_manifest.json (scans copado/functions and copado/templates)

```
USAGE
  $ agentia cicd extension create -n <value> [--json] [--overwrite] [--version <value>]

FLAGS
  -n, --name=<value>     (required) Extension name (alphanumeric, underscore, hyphen)
      --overwrite        Overwrite an existing extension_manifest.json
      --version=<value>  Initial semver version written to the manifest (X.Y.Z)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create or refresh a Copado extension manifest at copado/extension_manifest.json (scans copado/functions and
  copado/templates)

EXAMPLES
  $ agentia cicd extension create --name my-extension --version 1.0.0

  $ agentia cicd extension create --name my-extension --overwrite --json
```

_See code: [src/commands/cicd/extension/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/extension/create.ts)_

## `agentia cicd extension install [SOURCE]`

Install a Copado extension from a git URL or local folder: upsert functions and job templates via the CICD Gateway; deploy force-app with Salesforce CLI unless excluded

```
USAGE
  $ agentia cicd extension install [SOURCE] [--json] [--dry-run] [--exclude-sf-deploy] [--ignore-unknown-assets] [--ref
    <value>] [--sf-alias <value>] [--source <value>] [--version <value>] [-y]

ARGUMENTS
  [SOURCE]  Git repository URL, owner/repo slug, or local directory path

FLAGS
  -y, --yes                    Skip the interactive confirmation prompt (required for non-interactive / --json installs
                               that are not --dry-run)
      --dry-run                Materialize and validate, print the install plan, but do not upsert or deploy
      --exclude-sf-deploy      Skip Salesforce metadata deploy even when force-app is present
      --ignore-unknown-assets  Ignore unsupported manifest asset arrays instead of failing
      --ref=<value>            Git ref to install (tag, branch, or commit). Prefer --version for semver tags.
      --sf-alias=<value>       Salesforce CLI org alias or username for force-app deploy (required when force-app is
                               present unless --exclude-sf-deploy)
      --source=<value>         Git URL or local path (alternative to the positional source argument)
      --version=<value>        Semver version to install (checks out tag vX.Y.Z)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Install a Copado extension from a git URL or local folder: upsert functions and job templates via the CICD Gateway;
  deploy force-app with Salesforce CLI unless excluded

EXAMPLES
  $ agentia cicd extension install https://gitlab.com/org/my-ext.git --version 1.2.0 --yes

  $ agentia cicd extension install ./my-extension --version 0.1.0 --exclude-sf-deploy --yes

  $ agentia cicd extension install /tmp/my-extension.git --ref v0.1.0 --sf-alias destOrg --yes

  $ agentia cicd extension install ./my-extension --version 1.2.0 --exclude-sf-deploy --yes --json
```

_See code: [src/commands/cicd/extension/install.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/extension/install.ts)_

## `agentia cicd extension package`

Validate a Copado extension for publish (requires semver version; optional --version bump)

```
USAGE
  $ agentia cicd extension package [--json] [--version <value>]

FLAGS
  --version=<value>  Set or bump the manifest semver version before validating

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Validate a Copado extension for publish (requires semver version; optional --version bump)

EXAMPLES
  $ agentia cicd extension package

  $ agentia cicd extension package --version 1.2.0 --json
```

_See code: [src/commands/cicd/extension/package.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/extension/package.ts)_

## `agentia cicd extension publish`

Push the current extension commit and create an annotated semver git tag (vX.Y.Z) for install pinning

```
USAGE
  $ agentia cicd extension publish [--json] [--allow-dirty] [--force] [--local] [--remote <value>] [--version <value>]

FLAGS
  --allow-dirty      Allow publish with a dirty working tree
  --force            Recreate the local tag and push even if the tag already exists
  --local            Create the annotated tag locally without pushing to a remote (offline / local e2e)
  --remote=<value>   [default: origin] Git remote to push (default origin; ignored with --local)
  --version=<value>  Require this semver in the manifest before tagging (writes it only if already committed; fails if
                     the bump is uncommitted)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Push the current extension commit and create an annotated semver git tag (vX.Y.Z) for install pinning

EXAMPLES
  $ agentia cicd extension publish

  $ agentia cicd extension publish --version 1.2.0 --remote origin --json

  $ agentia cicd extension publish --version 0.1.0 --local --force
```

_See code: [src/commands/cicd/extension/publish.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/extension/publish.ts)_

## `agentia cicd extension uninstall [SOURCE]`

Uninstall a Copado extension by deleting the functions and job templates listed in its manifest from the authenticated Copado org

```
USAGE
  $ agentia cicd extension uninstall [SOURCE] [--json] [--dry-run] [--ref <value>] [--source <value>] [--version
  <value>] [-y]

ARGUMENTS
  [SOURCE]  Git repository URL, owner/repo slug, or local directory path

FLAGS
  -y, --yes              Skip the interactive confirmation prompt (required for non-interactive / --json uninstalls that
                         are not --dry-run)
      --dry-run          Show which assets would be deleted without calling the gateway
      --ref=<value>      Git ref to read the manifest from
      --source=<value>   Git URL or local path (alternative to the positional source argument)
      --version=<value>  Semver version whose tag (vX.Y.Z) supplies the manifest

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Uninstall a Copado extension by deleting the functions and job templates listed in its manifest from the authenticated
  Copado org

EXAMPLES
  $ agentia cicd extension uninstall ./my-extension --version 0.1.0 --yes

  $ agentia cicd extension uninstall https://gitlab.com/org/my-ext.git --ref v0.1.0 --yes --json
```

_See code: [src/commands/cicd/extension/uninstall.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/extension/uninstall.ts)_

## `agentia cicd extension validate`

Validate a Copado extension manifest against copado/functions and copado/templates on disk

```
USAGE
  $ agentia cicd extension validate [--json] [--require-version]

FLAGS
  --require-version  Require a semver version field (needed for package/publish)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Validate a Copado extension manifest against copado/functions and copado/templates on disk

EXAMPLES
  $ agentia cicd extension validate

  $ agentia cicd extension validate --require-version --json
```

_See code: [src/commands/cicd/extension/validate.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/extension/validate.ts)_

## `agentia cicd function defaults`

Scaffold default Copado Function metadata and script without writing to Salesforce

```
USAGE
  $ agentia cicd function defaults --name <value> [--json] [--image-name <value>] [--runtime bash|node|python]

FLAGS
  --image-name=<value>  [default: copado-function-core:v1] Function container image
  --name=<value>        (required) Function display name used to scaffold defaults
  --runtime=<option>    [default: bash] Script runtime
                        <options: bash|node|python>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Scaffold default Copado Function metadata and script without writing to Salesforce

EXAMPLES
  $ agentia cicd function defaults --name MyFunction

  $ agentia cicd function defaults --name MyFunction --runtime python --json
```

_See code: [src/commands/cicd/function/defaults.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/defaults.ts)_

## `agentia cicd function delete API-NAME`

Delete a Copado Function by API name

```
USAGE
  $ agentia cicd function delete API-NAME [--json]

ARGUMENTS
  API-NAME  Function API name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado Function by API name

EXAMPLES
  $ agentia cicd function delete myFunction

  $ agentia cicd function delete myFunction --json
```

_See code: [src/commands/cicd/function/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/delete.ts)_

## `agentia cicd function get API-NAME`

Get a Copado Function by API name

```
USAGE
  $ agentia cicd function get API-NAME [--json]

ARGUMENTS
  API-NAME  Function API name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado Function by API name

EXAMPLES
  $ agentia cicd function get myFunction

  $ agentia cicd function get myFunction --json
```

_See code: [src/commands/cicd/function/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/get.ts)_

## `agentia cicd function list`

List Copado Functions

```
USAGE
  $ agentia cicd function list [--json] [--cursor <value>] [--page-size <value>] [--image-name <value>] [--name <value>]
    [--size <value>] [--type custom|all]

FLAGS
  --cursor=<value>      Opaque pagination cursor from a previous list response (nextCursor)
  --image-name=<value>  Filter by function container image
  --name=<value>        Filter by name
  --page-size=<value>   Number of records per page (1-200)
  --size=<value>        Filter by function size
  --type=<option>       [default: custom] List Custom functions only, or all functions
                        <options: custom|all>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado Functions

EXAMPLES
  $ agentia cicd function list

  $ agentia cicd function list --type all

  $ agentia cicd function list --name MyFunction --size S

  $ agentia cicd function list --image-name copado-function-core:v1

  $ agentia cicd function list --page-size 50

  $ agentia cicd function list --cursor NEXT --json

  $ agentia cicd function list --json
```

_See code: [src/commands/cicd/function/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/list.ts)_

## `agentia cicd function open ID`

Open a Copado Function in the browser

```
USAGE
  $ agentia cicd function open ID [--json]

ARGUMENTS
  ID  Function ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado Function in the browser

EXAMPLES
  $ agentia cicd function open <function-id>

  $ agentia cicd function open <function-id> --json
```

_See code: [src/commands/cicd/function/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/open.ts)_

## `agentia cicd function result get RESULT-ID`

Get Copado Function execution status by result Id

```
USAGE
  $ agentia cicd function result get RESULT-ID [--json]

ARGUMENTS
  RESULT-ID  Function result Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get Copado Function execution status by result Id

EXAMPLES
  $ agentia cicd function result get <result-id>

  $ agentia cicd function result get <result-id> --json
```

_See code: [src/commands/cicd/function/result/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/result/get.ts)_

## `agentia cicd function result log get RESULT-ID`

Get log output for a Copado Function result

```
USAGE
  $ agentia cicd function result log get RESULT-ID [--json] [--type <value>]

ARGUMENTS
  RESULT-ID  Function result Id

FLAGS
  --type=<value>  Optional log file type filter

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get log output for a Copado Function result

EXAMPLES
  $ agentia cicd function result log get <result-id>

  $ agentia cicd function result log get <result-id> --type stdout

  $ agentia cicd function result log get <result-id> --json
```

_See code: [src/commands/cicd/function/result/log/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/result/log/get.ts)_

## `agentia cicd function run API-NAME`

Run a Copado Function and return the result Id

```
USAGE
  $ agentia cicd function run API-NAME [--json] [--context-id <value>] [--deploy-first] [--parameter <value>...]
    [--show-validation-errors]

ARGUMENTS
  API-NAME  Function API name

FLAGS
  --context-id=<value>           Execution context Id
  --deploy-first                 Deploy related metadata before running the function
  --parameter=<value>...         Run parameter as key=value (repeatable)
  --[no-]show-validation-errors  Surface validation errors from the gateway

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Run a Copado Function and return the result Id

EXAMPLES
  $ agentia cicd function run myFunction

  $ agentia cicd function run myFunction --parameter env=dev --json

  $ agentia cicd function run myFunction --context-id a00... --deploy-first --json
```

_See code: [src/commands/cicd/function/run.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/run.ts)_

## `agentia cicd function run-local SCRIPT`

Run a Copado Function script locally in Docker (no CICD gateway). Override --image when the Copado registry is unavailable.

```
USAGE
  $ agentia cicd function run-local SCRIPT [--json] [--cwd <value>] [-i <value>] [--parameter <value>...] [--platform
    <value>] [--runtime bash|node|python]

ARGUMENTS
  SCRIPT  Path to the local function script (.sh, .js, or .py)

FLAGS
  -i, --image=<value>         [default: copado-function-core:v1] Docker image used to run the function. Override when
                              the Copado image registry is unavailable (e.g. for partners).
      --cwd=<value>           Host directory bind-mounted at /app inside the container (defaults to the current working
                              directory)
      --parameter=<value>...  Environment variable for the script as key=value (repeatable)
      --platform=<value>      Docker --platform value (e.g. linux/amd64 on Apple Silicon)
      --runtime=<option>      Override runtime detection from the script extension
                              <options: bash|node|python>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Run a Copado Function script locally in Docker (no CICD gateway). Override --image when the Copado registry is
  unavailable.

EXAMPLES
  $ agentia cicd function run-local copado/functions/myFunction.sh

  $ agentia cicd function run-local ./myFunction.js --cwd . --image my-registry/function-core:v1 --parameter ENV=dev --json

  $ agentia cicd function run-local ./myFunction.py --runtime python --platform linux/amd64
```

_See code: [src/commands/cicd/function/run-local.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/run-local.ts)_

## `agentia cicd function upsert API-NAME`

Create or update a Copado Function by API name

```
USAGE
  $ agentia cicd function upsert API-NAME [--json] [--apex-class <value>] [--callback <value>] [--description <value>]
    [--file <value>] [--flow-handler <value>] [--image-name <value>] [--name <value>] [--parameters-file <value>]
    [--runtime bash|node|python] [--script <value>] [--script-file <value>] [--size <value>] [--timeout <value>] [--type
    <value>] [--version <value>]

ARGUMENTS
  API-NAME  Function API name

FLAGS
  --apex-class=<value>       Apex callback class
  --callback=<value>         Function callback type
  --description=<value>      Function description
  --file=<value>             Path to a JSON file with the full upsert payload (overrides individual script flags)
  --flow-handler=<value>     Flow handler name
  --image-name=<value>       Function container image
  --name=<value>             Function display name (defaults to the API name argument)
  --parameters-file=<value>  Path to a JSON file containing the parameters array
  --runtime=<option>         Script runtime
                             <options: bash|node|python>
  --script=<value>           Inline script content
  --script-file=<value>      Path to a file whose contents become the script
  --size=<value>             Function size
  --timeout=<value>          Function timeout in seconds
  --type=<value>             Function type
  --version=<value>          Function version

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create or update a Copado Function by API name

EXAMPLES
  $ agentia cicd function upsert myFunction --name "My Function" --script "echo hello"

  $ agentia cicd function upsert myFunction --script-file ./run.sh --runtime bash --json

  $ agentia cicd function upsert myFunction --file ./function.json --json
```

_See code: [src/commands/cicd/function/upsert.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/function/upsert.ts)_

## `agentia cicd health-check`

Run organization-scoped governance health checks

```
USAGE
  $ agentia cicd health-check [--json] [--path <value> --git-sizer]

FLAGS
  --git-sizer     Also analyze a local Git clone with git-sizer
  --path=<value>  Local Git clone for --git-sizer. Defaults to the current directory.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Run organization-scoped governance health checks

EXAMPLES
  $ agentia cicd health-check

  $ agentia cicd health-check --json

  $ agentia cicd health-check --git-sizer

  $ agentia cicd health-check --git-sizer --path /path/to/clone
```

_See code: [src/commands/cicd/health-check.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/health-check.ts)_

## `agentia cicd job get ID`

Get a Copado job execution with ordered steps

```
USAGE
  $ agentia cicd job get ID [--json]

ARGUMENTS
  ID  JobExecution Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado job execution with ordered steps

EXAMPLES
  $ agentia cicd job get <job-id>

  $ agentia cicd job get <job-id> --json
```

_See code: [src/commands/cicd/job/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/get.ts)_

## `agentia cicd job kill ID`

Cancel a Copado job execution

```
USAGE
  $ agentia cicd job kill ID [--json]

ARGUMENTS
  ID  JobExecution Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Cancel a Copado job execution

EXAMPLES
  $ agentia cicd job kill <job-id>

  $ agentia cicd job kill <job-id> --json
```

_See code: [src/commands/cicd/job/kill.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/kill.ts)_

## `agentia cicd job list`

List Copado job executions

```
USAGE
  $ agentia cicd job list [--json] [--cursor <value>] [--page-size <value>] [--context <value>] [--id <value>]
    [--mine] [--name <value>] [--parent <value>] [--status <value>] [--type <value>]

FLAGS
  --context=<value>    Contains match on JobExecution context
  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
  --id=<value>         Exact JobExecution Id
  --mine               List only jobs owned by the current user
  --name=<value>       Contains match on JobExecution name
  --page-size=<value>  Number of records per page (1-200)
  --parent=<value>     Exact parent record Id
  --status=<value>     Exact Copado job status
  --type=<value>       Contains match on Job Template name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado job executions

EXAMPLES
  $ agentia cicd job list

  $ agentia cicd job list --status "In Progress" --page-size 50

  $ agentia cicd job list --name JE- --type Deploy --parent <parent-id>

  $ agentia cicd job list --json
```

_See code: [src/commands/cicd/job/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/list.ts)_

## `agentia cicd job log get ID`

Get log output for a Copado job execution step

```
USAGE
  $ agentia cicd job log get ID [--json] [--step <value>]

ARGUMENTS
  ID  JobExecution Id

FLAGS
  --step=<value>  Job step Id (defaults to the first step with a result Id)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get log output for a Copado job execution step

EXAMPLES
  $ agentia cicd job log get <job-id>

  $ agentia cicd job log get <job-id> --step <step-id>

  $ agentia cicd job log get <job-id> --json
```

_See code: [src/commands/cicd/job/log/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/log/get.ts)_

## `agentia cicd job open ID`

Open a Copado job execution in the browser

```
USAGE
  $ agentia cicd job open ID [--json]

ARGUMENTS
  ID  JobExecution ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado job execution in the browser

EXAMPLES
  $ agentia cicd job open <job-id>

  $ agentia cicd job open <job-id> --json
```

_See code: [src/commands/cicd/job/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/open.ts)_

## `agentia cicd job pause ID`

Pause a Copado job execution (resumable cancel alias)

```
USAGE
  $ agentia cicd job pause ID [--json]

ARGUMENTS
  ID  JobExecution Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Pause a Copado job execution (resumable cancel alias)

EXAMPLES
  $ agentia cicd job pause <job-id>

  $ agentia cicd job pause <job-id> --json
```

_See code: [src/commands/cicd/job/pause.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/pause.ts)_

## `agentia cicd job result-file get RESULTID`

Get a File linked to a Copado job Result

```
USAGE
  $ agentia cicd job result-file get RESULTID --file-id <value> [--json] [--output-file <value>]

ARGUMENTS
  RESULTID  Copado Result Id

FLAGS
  --file-id=<value>      (required) File Id returned by result-file list
  --output-file=<value>  Explicit file path to receive decoded content

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a File linked to a Copado job Result

EXAMPLES
  $ agentia cicd job result-file get <result-id> --file-id <file-id>

  $ agentia cicd job result-file get <result-id> --file-id <file-id> --output-file ./result.zip

  $ agentia cicd job result-file get <result-id> --file-id <file-id> --json
```

_See code: [src/commands/cicd/job/result-file/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/result-file/get.ts)_

## `agentia cicd job result-file list RESULTID`

List Files linked to a Copado job Result

```
USAGE
  $ agentia cicd job result-file list RESULTID [--json]

ARGUMENTS
  RESULTID  Copado Result Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Files linked to a Copado job Result

EXAMPLES
  $ agentia cicd job result-file list <result-id>

  $ agentia cicd job result-file list <result-id> --json
```

_See code: [src/commands/cicd/job/result-file/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/result-file/list.ts)_

## `agentia cicd job resume ID`

Resume outstanding steps for a Copado job execution

```
USAGE
  $ agentia cicd job resume ID [--json]

ARGUMENTS
  ID  JobExecution Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Resume outstanding steps for a Copado job execution

EXAMPLES
  $ agentia cicd job resume <job-id>

  $ agentia cicd job resume <job-id> --json
```

_See code: [src/commands/cicd/job/resume.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/resume.ts)_

## `agentia cicd job run ID`

Run all steps for a Copado job execution

```
USAGE
  $ agentia cicd job run ID [--json] [--restart]

ARGUMENTS
  ID  JobExecution Id

FLAGS
  --restart  Restart the job run (gateway compatibility flag)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Run all steps for a Copado job execution

EXAMPLES
  $ agentia cicd job run <job-id>

  $ agentia cicd job run <job-id> --restart --json
```

_See code: [src/commands/cicd/job/run.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/job/run.ts)_

## `agentia cicd metadata content compare`

Compare metadata file content between two orgs or Git branches

```
USAGE
  $ agentia cicd metadata content compare --api-name <value> --metadata-type <value> [--json] [--file-name <value>] [--pipeline-id
    <value>] [--source ENVIRONMENT|REPOSITORY|GIT_MIRROR|ORG_CACHE] [--source-branch <value>] [--source-credential-id
    <value>] [--source-org-id <value>] [--target-branch <value>] [--target-credential-id <value>] [--target-org-id
    <value>] [--target-source ENVIRONMENT|REPOSITORY|GIT_MIRROR|ORG_CACHE]

FLAGS
  --api-name=<value>              (required) Metadata API name
  --file-name=<value>             Optional metadata file name
  --metadata-type=<value>         (required) Metadata type, for example ApexClass
  --pipeline-id=<value>           Pipeline Id
  --source=<option>               [default: ENVIRONMENT] Content source for the source side
                                  <options: ENVIRONMENT|REPOSITORY|GIT_MIRROR|ORG_CACHE>
  --source-branch=<value>         Git branch for the source side when source is REPOSITORY or GIT_MIRROR
  --source-credential-id=<value>  Source org credential Id
  --source-org-id=<value>         Source org Id
  --target-branch=<value>         Git branch for the target side when target source is REPOSITORY or GIT_MIRROR
  --target-credential-id=<value>  Target org credential Id; defaults to the source credential
  --target-org-id=<value>         Target org Id
  --target-source=<option>        [default: ENVIRONMENT] Content source for the target side
                                  <options: ENVIRONMENT|REPOSITORY|GIT_MIRROR|ORG_CACHE>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Compare metadata file content between two orgs or Git branches

EXAMPLES
  $ agentia cicd metadata content compare --metadata-type ApexClass --api-name MyClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>

  $ agentia cicd metadata content compare --metadata-type ApexClass --api-name MyClass --source REPOSITORY --source-branch feature/us-123 --target-source REPOSITORY --target-branch main

  $ agentia cicd metadata content compare --metadata-type ApexClass --api-name MyClass --json
```

_See code: [src/commands/cicd/metadata/content/compare.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/metadata/content/compare.ts)_

## `agentia cicd metadata content get`

Retrieve metadata file content

```
USAGE
  $ agentia cicd metadata content get [--json] [--api-name <value>] [--branch <value>] [--file <value>] [--file-name <value>]
    [--metadata-type <value>] [--output-file <value>] [--pipeline-id <value>] [--result-id <value>] [--show] [--source
    ENVIRONMENT|REPOSITORY|GIT_MIRROR|ORG_CACHE] [--source-credential-id <value>] [--source-org-id <value>]

FLAGS
  --api-name=<value>              Metadata API name
  --branch=<value>                Git branch when source is REPOSITORY or GIT_MIRROR
  --file=<value>                  Path to a JSON file with an array of metadata content requests
  --file-name=<value>             Optional metadata file name
  --metadata-type=<value>         Metadata type, for example ApexClass
  --output-file=<value>           Write decoded content from the first result to this file path
  --pipeline-id=<value>           Pipeline Id
  --result-id=<value>             Optional result Id from a prior metadata operation
  --show                          Print decoded metadata content to stdout after retrieval
  --source=<option>               [default: ENVIRONMENT] Content source
                                  <options: ENVIRONMENT|REPOSITORY|GIT_MIRROR|ORG_CACHE>
  --source-credential-id=<value>  Source org credential Id
  --source-org-id=<value>         Source org Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Retrieve metadata file content

EXAMPLES
  $ agentia cicd metadata content get --metadata-type ApexClass --api-name MyClass --pipeline-id <id> --source-org-id <id>

  $ agentia cicd metadata content get --metadata-type ApexClass --api-name MyClass --show

  $ agentia cicd metadata content get --file requests.json --json
```

_See code: [src/commands/cicd/metadata/content/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/metadata/content/get.ts)_

## `agentia cicd metadata dependency list`

Retrieve metadata dependencies

```
USAGE
  $ agentia cicd metadata dependency list [--json] [--base-ref <value>] [-f <value>] [--from-changes] [--metadata-category <value>]
    [--metadata-name <value>] [--metadata-raw-json <value>] [--metadata-type <value>] [--module-type vlocity|data_cloud]
    [--pipeline-id <value>] [--platform-experience salesforce|sfdx|metacache|db] [--result-id <value>] [--retrieve-mode
    all|diff_only] [--source-credential-id <value>] [--source-org-id <value>] [--stdin] [--target-org-id <value>]

FLAGS
  -f, --file=<value>                  Path to a JSON dependency request body
      --base-ref=<value>              [default: origin/main] Base Git ref used with --from-changes
      --from-changes                  Build metadata selections from committed branch changes and staged index files
      --metadata-category=<value>     Optional metadata category
      --metadata-name=<value>         Metadata component name
      --metadata-raw-json=<value>     Optional raw metadata JSON for the selection
      --metadata-type=<value>         Metadata type, for example ApexClass
      --module-type=<option>          Optional addon module type
                                      <options: vlocity|data_cloud>
      --pipeline-id=<value>           Pipeline Id
      --platform-experience=<option>  [default: salesforce] Platform experience header
                                      <options: salesforce|sfdx|metacache|db>
      --result-id=<value>             Optional result Id from a prior metadata operation
      --retrieve-mode=<option>        Dependency retrieve mode
                                      <options: all|diff_only>
      --source-credential-id=<value>  Source org credential Id
      --source-org-id=<value>         Source org Id
      --stdin                         Read a JSON dependency request body from stdin
      --target-org-id=<value>         Target org Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Retrieve metadata dependencies

EXAMPLES
  $ agentia cicd metadata dependency list --metadata-name MyClass --metadata-type ApexClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id>

  cat request.json | agentia cicd metadata dependency list --stdin

  $ agentia cicd metadata dependency list --from-changes --base-ref origin/main --retrieve-mode all --pipeline-id <id> --source-org-id <id> --source-credential-id <id>
```

_See code: [src/commands/cicd/metadata/dependency/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/metadata/dependency/list.ts)_

## `agentia cicd metadata explore`

Explore Salesforce metadata through Org Intelligence. Uses the project default credential when --credential-id is omitted; otherwise pass --credential-id, or both --session-id and --endpoint.

```
USAGE
  $ agentia cicd metadata explore --action list|search|read_documentation|describe_type|read|find_references|run_apex_tests
    [--json] [--apex-unit-tests <value>] [--credential-id <value>] [--endpoint <value>] [--full-name <value>]
    [--object-type <value>] [--pattern <value>] [--session-id <value>]

FLAGS
  --action=<option>          (required) Metadata action: list, search, read_documentation, describe_type, read,
                             find_references, run_apex_tests
                             <options: list|search|read_documentation|describe_type|read|find_references|run_apex_tests>
  --apex-unit-tests=<value>  Comma-separated Apex test classes. Required for run_apex_tests.
  --credential-id=<value>    Copado credential Id for the target org. Defaults to the CICD project default credential
                             when set.
  --endpoint=<value>         Salesforce instance URL (with --session-id) when not using a credential. Exclusive with
                             --credential-id.
  --full-name=<value>        Fully qualified metadata name (required for read; list results emit this as fullName)
  --object-type=<value>      Metadata type, for example ApexClass, CustomObject, or Flow
  --pattern=<value>          [default: *] Wildcard pattern for list/search (name without namespace), for example
                             Account* or *Info
  --session-id=<value>       Salesforce session Id (with --endpoint) when not using a credential. Exclusive with
                             --credential-id.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Explore Salesforce metadata through Org Intelligence. Uses the project default credential when --credential-id is
  omitted; otherwise pass --credential-id, or both --session-id and --endpoint.

EXAMPLES
  $ agentia cicd metadata explore --action list --object-type ApexClass

  $ agentia cicd metadata explore --action list --object-type ApexClass --pattern 'Account*'

  $ agentia cicd metadata explore --action read --object-type ApexClass --full-name MyClass

  $ agentia cicd metadata explore --action find_references --object-type ApexClass --full-name MyClass

  $ agentia cicd metadata explore --action search --pattern 'Cont*' --credential-id <id>

  $ agentia cicd metadata explore --action describe_type --object-type CustomObject --json
```

_See code: [src/commands/cicd/metadata/explore.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/metadata/explore.ts)_

## `agentia cicd metadata index compare`

Compare metadata between orgs or Git branches

```
USAGE
  $ agentia cicd metadata index compare [--json] [--comparison-mode BRANCH_COMPARE|INDEX_FILE|MIX] [--filter-type <value>]
    [--pipeline-id <value>] [--source-credential-id <value>] [--source-org-id <value>] [--target-org-id <value>]

FLAGS
  --comparison-mode=<option>      [default: BRANCH_COMPARE] Comparison mode
                                  <options: BRANCH_COMPARE|INDEX_FILE|MIX>
  --filter-type=<value>           Optional metadata type filter, for example ApexClass
  --pipeline-id=<value>           Pipeline Id
  --source-credential-id=<value>  Source org credential Id
  --source-org-id=<value>         Source org Id
  --target-org-id=<value>         Target org Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Compare metadata between orgs or Git branches

EXAMPLES
  $ agentia cicd metadata index compare --comparison-mode BRANCH_COMPARE --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>

  $ agentia cicd metadata index compare --comparison-mode INDEX_FILE --filter-type ApexClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>

  $ agentia cicd metadata index compare --comparison-mode MIX --json
```

_See code: [src/commands/cicd/metadata/index/compare.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/metadata/index/compare.ts)_

## `agentia cicd metadata list`

Search the metadata index for an org

```
USAGE
  $ agentia cicd metadata list [--json] [--avoid-source-tracking] [--change-date-from <value>] [--change-date-to
    <value>] [--filter-type <value>] [--find-managed-packages] [--limit <value>] [--metadata-types <value>]
    [--modified-by <value>] [--module-type vlocity|data_cloud] [--order-direction ASC|DESC] [--pipeline-id <value>]
    [--platform-experience salesforce|sfdx|metacache|db] [--source
    All|Changed|Deleted|New|NewAndChanged|PreviouslyCommitted] [--source-credential-id <value>] [--source-org-id
    <value>] [--target-org-id <value>]

FLAGS
  --avoid-source-tracking         Pass avoidSourceTracking=true to the index route
  --change-date-from=<value>      Optional change-date-from filter (ISO datetime)
  --change-date-to=<value>        Optional change-date-to filter (ISO datetime)
  --filter-type=<value>           Optional metadata type name filter, for example ApexClass
  --find-managed-packages         Include managed package metadata in the search
  --limit=<value>                 Maximum number of records to return
  --metadata-types=<value>        Optional comma-separated metadata types to include
  --modified-by=<value>           Filter by last modified user
  --module-type=<option>          Optional addon module type
                                  <options: vlocity|data_cloud>
  --order-direction=<option>      Sort direction for last modified date
                                  <options: ASC|DESC>
  --pipeline-id=<value>           Pipeline Id
  --platform-experience=<option>  [default: salesforce] Platform experience header
                                  <options: salesforce|sfdx|metacache|db>
  --source=<option>               Index source filter
                                  <options: All|Changed|Deleted|New|NewAndChanged|PreviouslyCommitted>
  --source-credential-id=<value>  Source org credential Id
  --source-org-id=<value>         Source org Id
  --target-org-id=<value>         Optional target org Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Search the metadata index for an org

EXAMPLES
  $ agentia cicd metadata list --pipeline-id <id> --source-org-id <id> --source-credential-id <id>

  $ agentia cicd metadata list --source Changed --metadata-types ApexClass --limit 100 --pipeline-id <id> --source-org-id <id> --source-credential-id <id>

  $ agentia cicd metadata list --source NewAndChanged --find-managed-packages --json
```

_See code: [src/commands/cicd/metadata/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/metadata/list.ts)_

## `agentia cicd metadata refresh deleted`

Refresh the deleted metadata index

```
USAGE
  $ agentia cicd metadata refresh deleted [--json] [--env <value>] [--module-type vlocity|data_cloud] [--source-credential-id
    <value>] [--source-org-id <value>]

FLAGS
  --env=<value>                   Copado environment Id used to resolve the credential
  --module-type=<option>          Optional addon module type
                                  <options: vlocity|data_cloud>
  --source-credential-id=<value>  Override source credential Id resolved from --env
  --source-org-id=<value>         Override source org Id resolved from --env validation

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Refresh the deleted metadata index

EXAMPLES
  $ agentia cicd metadata refresh deleted --env <environment-id>

  $ agentia cicd metadata refresh deleted --env <environment-id> --module-type vlocity --json
```

_See code: [src/commands/cicd/metadata/refresh/deleted.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/metadata/refresh/deleted.ts)_

## `agentia cicd metadata refresh run`

Trigger a metadata index refresh

```
USAGE
  $ agentia cicd metadata refresh run [--json] [--all] [--env <value>] [--git-files <value>] [--module-type vlocity|data_cloud]
    [--pipeline-id <value>] [--platform-experience salesforce|sfdx|metacache|db] [--refresh-mode <value>]
    [--selected-name <value>] [--selected-type <value>] [--source-credential-id <value>] [--source-org-id <value>]
    [--target-org-id <value>]

FLAGS
  --all                           Request replacing the metadata index instead of merging it
  --env=<value>                   Copado environment Id used to resolve source org and credential
  --git-files=<value>             Comma-separated Git file paths to refresh
  --module-type=<option>          Optional addon module type
                                  <options: vlocity|data_cloud>
  --pipeline-id=<value>           Optional pipeline Id
  --platform-experience=<option>  [default: salesforce] Platform experience header
                                  <options: salesforce|sfdx|metacache|db>
  --refresh-mode=<value>          Optional refresh mode
  --selected-name=<value>         Optional selected metadata API name
  --selected-type=<value>         Optional selected metadata type
  --source-credential-id=<value>  Override source credential Id resolved from --env
  --source-org-id=<value>         Override source org Id resolved from --env
  --target-org-id=<value>         Optional target org Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Trigger a metadata index refresh

EXAMPLES
  $ agentia cicd metadata refresh run --env <environment-id>

  $ agentia cicd metadata refresh run --env <environment-id> --all --json
```

_See code: [src/commands/cicd/metadata/refresh/run.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/metadata/refresh/run.ts)_

## `agentia cicd metadata refresh status`

Get metadata index refresh status

```
USAGE
  $ agentia cicd metadata refresh status [--json] [--job-id <value>] [--module-type vlocity|data_cloud] [--platform-experience
    salesforce|sfdx|metacache|db]

FLAGS
  --job-id=<value>                Metadata refresh event Id
  --module-type=<option>          Optional addon module type used by the trigger request
                                  <options: vlocity|data_cloud>
  --platform-experience=<option>  [default: salesforce] Platform experience header used by the trigger request
                                  <options: salesforce|sfdx|metacache|db>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get metadata index refresh status

EXAMPLES
  $ agentia cicd metadata refresh status --job-id <event-id>

  $ agentia cicd metadata refresh status --job-id <event-id> --json
```

_See code: [src/commands/cicd/metadata/refresh/status.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/metadata/refresh/status.ts)_

## `agentia cicd notification configure`

Configure one Slack notification subscription for the current user on a pipeline

```
USAGE
  $ agentia cicd notification configure --destination-id <value> --destination-type user|channel --event
    Promotion_Success|Promotion_Failed|Promotion_Conflict|Failed_Promotion_Creation|Deploy_Success|Deploy_Failed|Commit_
    Failed|Successful_Snapshot|Failed_Snapshot|ManualTask_Assigned|Test_Success|Test_Failed|Test_Cancelled|Test_Not
    Started|Quality_Gate_Success|Quality_Gate_Failed|Quality_Gate_Cancelled|Quality_Gate_Not
    Started|Create_Package_Success|Create_Package_Failure|Generate_Package_Version_Success|Generate_Package_Version_Fail
    ure|Import_Package_Success|Import_Package_Failure|Publish_Package_Success|Publish_Package_Failure -p <value>
    --subscription user|all [--json]

FLAGS
  -p, --pipeline-id=<value>
      (required) Copado pipeline Salesforce Id

  --destination-id=<value>
      (required) Slack user or channel id or name

  --destination-type=<option>
      (required) Slack destination type
      <options: user|channel>

  --event=<option>
      (required) Notification event
      <options:
      Promotion_Success|Promotion_Failed|Promotion_Conflict|Failed_Promotion_Creation|Deploy_Success|Deploy_Failed|Commit_
      Failed|Successful_Snapshot|Failed_Snapshot|ManualTask_Assigned|Test_Success|Test_Failed|Test_Cancelled|Test_Not
      Started|Quality_Gate_Success|Quality_Gate_Failed|Quality_Gate_Cancelled|Quality_Gate_Not
      Started|Create_Package_Success|Create_Package_Failure|Generate_Package_Version_Success|Generate_Package_Version_Fail
      ure|Import_Package_Success|Import_Package_Failure|Publish_Package_Success|Publish_Package_Failure>

  --subscription=<option>
      (required) Notification audience for this event
      <options: user|all>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Configure one Slack notification subscription for the current user on a pipeline

EXAMPLES
  $ agentia cicd notification configure --pipeline-id <pipeline-id> --event Promotion_Failed --destination-type user --destination-id U0123ABCD --subscription user

  $ agentia cicd notification configure -p <pipeline-id> --event Commit_Failed --destination-type channel --destination-id C0123ABCD --subscription all

  $ agentia cicd notification configure --pipeline-id <pipeline-id> --event "Test_Not Started" --destination-type user --destination-id @jane --subscription user --json
```

_See code: [src/commands/cicd/notification/configure.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/notification/configure.ts)_

## `agentia cicd notification get`

List Slack notification subscriptions for the current user on a pipeline

```
USAGE
  $ agentia cicd notification get -p <value> [--json]

FLAGS
  -p, --pipeline-id=<value>  (required) Copado pipeline Salesforce Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Slack notification subscriptions for the current user on a pipeline

EXAMPLES
  $ agentia cicd notification get --pipeline-id <pipeline-id>

  $ agentia cicd notification get -p <pipeline-id> --json
```

_See code: [src/commands/cicd/notification/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/notification/get.ts)_

## `agentia cicd pipeline automation activate ID`

Activate a Copado pipeline automation rule

```
USAGE
  $ agentia cicd pipeline automation activate ID --pipeline-id <value> [--json]

ARGUMENTS
  ID  Automation rule Salesforce ID (not name)

FLAGS
  --pipeline-id=<value>  (required) Pipeline ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Activate a Copado pipeline automation rule

EXAMPLES
  $ agentia cicd pipeline automation activate <rule-id> --pipeline-id <pipeline-id>

  $ agentia cicd pipeline automation activate <rule-id> --pipeline-id <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/automation/activate.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/automation/activate.ts)_

## `agentia cicd pipeline automation create`

Create an inactive Copado pipeline automation rule

```
USAGE
  $ agentia cicd pipeline automation create --pipeline-id <value> [--json] [--callback-action <value>] [--cron-expression <value>]
    [--custom-automation-connector <value>] [--description <value>] [--environment-id <value>...]
    [--environment-sync-source <value>] [--execution-time Immediate|Scheduled] [--filter-criteria <value> |
    --filter-criteria-file <value>] [--name <value>] [--promotion-trigger manual|automated] [--scope
    promotion|backPromotion|environmentSyncBackPromotion|advanced] [--source-action
    Promotion|PromotionDeployment|Commit|CreatePackage|CreatePackageVersion|PublishPackageVersion|ImportPackage|TakeSnap
    shot|Rollback|PackageDistribution|Platform|SubmitUserStories|Submit] [--source-action-status Successful|Error]
    [--stage-id <value>...]

FLAGS
  --callback-action=<value>
      Callback action for the automation rule

  --cron-expression=<value>
      Cron expression (required when execution time is Scheduled)

  --custom-automation-connector=<value>
      Custom automation connector (required for advanced scope)

  --description=<value>
      Automation rule description

  --environment-id=<value>...
      Environment ID target (repeatable; at least one --stage-id or --environment-id is required on create)

  --environment-sync-source=<value>
      Source environment ID (required for environmentSyncBackPromotion scope)

  --execution-time=<option>
      When the rule runs (Immediate, Scheduled); Scheduled requires --cron-expression
      <options: Immediate|Scheduled>

  --filter-criteria=<value>
      User-story filter as JSON. Restricts which user stories the rule applies to. Builder mode matches field conditions
      with AND/OR logic:
      '{"mode":"builder","logic":"AND","conditions":[{"field":"Name","operator":"equals","value":"US-1"}]}'. Custom mode
      sends a SOQL-like whereCondition: '{"mode":"custom","whereCondition":"Name LIKE \'US-%\'"}'. Operators: equals,
      notEquals, contains, notContains, greaterThan, greaterOrEqual, lessThan, lessOrEqual.

  --filter-criteria-file=<value>
      Path to a JSON file with the user-story filter shape documented on --filter-criteria (builder or custom mode)

  --name=<value>
      Automation rule name

  --pipeline-id=<value>
      (required) Pipeline ID or name

  --promotion-trigger=<option>
      Promotion trigger for promotion scope (manual, automated); manual maps to SubmitUserStories, automated to
      PromotionDeployment
      <options: manual|automated>

  --scope=<option>
      Automation scope (promotion, backPromotion, environmentSyncBackPromotion, advanced); immutable after create
      <options: promotion|backPromotion|environmentSyncBackPromotion|advanced>

  --source-action=<option>
      Source action for advanced scope (Promotion, PromotionDeployment, Commit, CreatePackage, CreatePackageVersion,
      PublishPackageVersion, ImportPackage, TakeSnapshot, Rollback, PackageDistribution, Platform, SubmitUserStories,
      Submit)
      <options: Promotion|PromotionDeployment|Commit|CreatePackage|CreatePackageVersion|PublishPackageVersion|ImportPackag
      e|TakeSnapshot|Rollback|PackageDistribution|Platform|SubmitUserStories|Submit>

  --source-action-status=<option>
      Source action status for advanced scope (Successful, Error)
      <options: Successful|Error>

  --stage-id=<value>...
      Stage ID target (repeatable; at least one --stage-id or --environment-id is required on create)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create an inactive Copado pipeline automation rule

EXAMPLES
  $ agentia cicd pipeline automation create --pipeline-id <pipeline-id> --name "Promote after successful deploy" --scope promotion --execution-time Immediate --promotion-trigger automated --environment-id <env-id>

  $ agentia cicd pipeline automation create --pipeline-id <pipeline-id> --name "Nightly back promote" --scope backPromotion --execution-time Scheduled --cron-expression "0 2 * * *" --stage-id <stage-id> --json

  $ agentia cicd pipeline automation create --pipeline-id <pipeline-id> --name "Promote matching stories" --scope promotion --execution-time Immediate --promotion-trigger manual --environment-id <env-id> --filter-criteria '{"mode":"builder","logic":"AND","conditions":[{"field":"Name","operator":"contains","value":"US-"}]}'

  $ agentia cicd pipeline automation create --pipeline-id <pipeline-id> --name "Custom after commit" --scope advanced --execution-time Immediate --source-action Commit --source-action-status Successful --custom-automation-connector <connector-id> --environment-id <env-id>
```

_See code: [src/commands/cicd/pipeline/automation/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/automation/create.ts)_

## `agentia cicd pipeline automation deactivate ID`

Deactivate a Copado pipeline automation rule

```
USAGE
  $ agentia cicd pipeline automation deactivate ID --pipeline-id <value> [--json]

ARGUMENTS
  ID  Automation rule Salesforce ID (not name)

FLAGS
  --pipeline-id=<value>  (required) Pipeline ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Deactivate a Copado pipeline automation rule

EXAMPLES
  $ agentia cicd pipeline automation deactivate <rule-id> --pipeline-id <pipeline-id>

  $ agentia cicd pipeline automation deactivate <rule-id> --pipeline-id <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/automation/deactivate.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/automation/deactivate.ts)_

## `agentia cicd pipeline automation delete ID`

Delete a Copado pipeline automation rule

```
USAGE
  $ agentia cicd pipeline automation delete ID --pipeline-id <value> [--json] [-y]

ARGUMENTS
  ID  Automation rule ID or name

FLAGS
  -y, --yes                  Confirm deletion without prompting
      --pipeline-id=<value>  (required) Pipeline ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado pipeline automation rule

EXAMPLES
  $ agentia cicd pipeline automation delete <rule-id> --pipeline-id <pipeline-id> --yes

  $ agentia cicd pipeline automation delete <rule-id> --pipeline-id <pipeline-id> --yes --json
```

_See code: [src/commands/cicd/pipeline/automation/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/automation/delete.ts)_

## `agentia cicd pipeline automation get ID`

Get a Copado pipeline automation rule

```
USAGE
  $ agentia cicd pipeline automation get ID --pipeline-id <value> [--json]

ARGUMENTS
  ID  Automation rule ID or name

FLAGS
  --pipeline-id=<value>  (required) Pipeline ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado pipeline automation rule

EXAMPLES
  $ agentia cicd pipeline automation get <rule-id> --pipeline-id <pipeline-id>

  $ agentia cicd pipeline automation get <rule-id> --pipeline-id <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/automation/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/automation/get.ts)_

## `agentia cicd pipeline automation list`

List Copado pipeline automation rules

```
USAGE
  $ agentia cicd pipeline automation list --pipeline-id <value> [--json] [--cursor <value>] [--page-size <value>] [--active]
    [--execution-time Immediate|Scheduled] [--include-system-generated] [--name <value>] [--source-action
    Promotion|PromotionDeployment|Commit|CreatePackage|CreatePackageVersion|PublishPackageVersion|ImportPackage|TakeSnap
    shot|Rollback|PackageDistribution|Platform|SubmitUserStories|Submit]

FLAGS
  --[no-]active
      Filter by active status

  --cursor=<value>
      Opaque pagination cursor from a previous list response (nextCursor)

  --execution-time=<option>
      Filter by execution time (Immediate, Scheduled)
      <options: Immediate|Scheduled>

  --include-system-generated
      Include system-generated automation rules

  --name=<value>
      Filter by automation rule name

  --page-size=<value>
      Number of records per page (1-200)

  --pipeline-id=<value>
      (required) Pipeline ID or name

  --source-action=<option>
      Filter by source action (Promotion, PromotionDeployment, Commit, CreatePackage, CreatePackageVersion,
      PublishPackageVersion, ImportPackage, TakeSnapshot, Rollback, PackageDistribution, Platform, SubmitUserStories,
      Submit)
      <options: Promotion|PromotionDeployment|Commit|CreatePackage|CreatePackageVersion|PublishPackageVersion|ImportPackag
      e|TakeSnapshot|Rollback|PackageDistribution|Platform|SubmitUserStories|Submit>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado pipeline automation rules

EXAMPLES
  $ agentia cicd pipeline automation list --pipeline-id <pipeline-id>

  $ agentia cicd pipeline automation list --pipeline-id <pipeline-id> --active --json

  $ agentia cicd pipeline automation list --pipeline-id <pipeline-id> --include-system-generated
```

_See code: [src/commands/cicd/pipeline/automation/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/automation/list.ts)_

## `agentia cicd pipeline automation open ID`

Open a Copado pipeline automation rule in the browser

```
USAGE
  $ agentia cicd pipeline automation open ID [--json]

ARGUMENTS
  ID  Automation rule Salesforce ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado pipeline automation rule in the browser

EXAMPLES
  $ agentia cicd pipeline automation open <rule-id>

  $ agentia cicd pipeline automation open <rule-id> --json
```

_See code: [src/commands/cicd/pipeline/automation/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/automation/open.ts)_

## `agentia cicd pipeline automation update ID`

Update a Copado pipeline automation rule

```
USAGE
  $ agentia cicd pipeline automation update ID --pipeline-id <value> [--json] [--callback-action <value>] [--cron-expression <value>]
    [--custom-automation-connector <value>] [--description <value>] [--environment-id <value>...]
    [--environment-sync-source <value>] [--execution-time Immediate|Scheduled] [--filter-criteria <value> |
    --filter-criteria-file <value>] [--name <value>] [--promotion-trigger manual|automated] [--scope
    promotion|backPromotion|environmentSyncBackPromotion|advanced] [--source-action
    Promotion|PromotionDeployment|Commit|CreatePackage|CreatePackageVersion|PublishPackageVersion|ImportPackage|TakeSnap
    shot|Rollback|PackageDistribution|Platform|SubmitUserStories|Submit] [--source-action-status Successful|Error]
    [--stage-id <value>...]

ARGUMENTS
  ID  Automation rule ID or name

FLAGS
  --callback-action=<value>
      Callback action for the automation rule

  --cron-expression=<value>
      Cron expression (required when execution time is Scheduled)

  --custom-automation-connector=<value>
      Custom automation connector (required for advanced scope)

  --description=<value>
      Automation rule description

  --environment-id=<value>...
      Environment ID target (repeatable; at least one --stage-id or --environment-id is required on create)

  --environment-sync-source=<value>
      Source environment ID (required for environmentSyncBackPromotion scope)

  --execution-time=<option>
      When the rule runs (Immediate, Scheduled); Scheduled requires --cron-expression
      <options: Immediate|Scheduled>

  --filter-criteria=<value>
      User-story filter as JSON. Restricts which user stories the rule applies to. Builder mode matches field conditions
      with AND/OR logic:
      '{"mode":"builder","logic":"AND","conditions":[{"field":"Name","operator":"equals","value":"US-1"}]}'. Custom mode
      sends a SOQL-like whereCondition: '{"mode":"custom","whereCondition":"Name LIKE \'US-%\'"}'. Operators: equals,
      notEquals, contains, notContains, greaterThan, greaterOrEqual, lessThan, lessOrEqual.

  --filter-criteria-file=<value>
      Path to a JSON file with the user-story filter shape documented on --filter-criteria (builder or custom mode)

  --name=<value>
      Automation rule name

  --pipeline-id=<value>
      (required) Pipeline ID or name

  --promotion-trigger=<option>
      Promotion trigger for promotion scope (manual, automated); manual maps to SubmitUserStories, automated to
      PromotionDeployment
      <options: manual|automated>

  --scope=<option>
      Automation scope (promotion, backPromotion, environmentSyncBackPromotion, advanced); immutable after create
      <options: promotion|backPromotion|environmentSyncBackPromotion|advanced>

  --source-action=<option>
      Source action for advanced scope (Promotion, PromotionDeployment, Commit, CreatePackage, CreatePackageVersion,
      PublishPackageVersion, ImportPackage, TakeSnapshot, Rollback, PackageDistribution, Platform, SubmitUserStories,
      Submit)
      <options: Promotion|PromotionDeployment|Commit|CreatePackage|CreatePackageVersion|PublishPackageVersion|ImportPackag
      e|TakeSnapshot|Rollback|PackageDistribution|Platform|SubmitUserStories|Submit>

  --source-action-status=<option>
      Source action status for advanced scope (Successful, Error)
      <options: Successful|Error>

  --stage-id=<value>...
      Stage ID target (repeatable; at least one --stage-id or --environment-id is required on create)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado pipeline automation rule

EXAMPLES
  $ agentia cicd pipeline automation update <rule-id> --pipeline-id <pipeline-id> --name "Renamed rule"

  $ agentia cicd pipeline automation update <rule-id> --pipeline-id <pipeline-id> --execution-time Scheduled --cron-expression "0 2 * * *" --json
```

_See code: [src/commands/cicd/pipeline/automation/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/automation/update.ts)_

## `agentia cicd pipeline connection create`

Create one or more Copado pipeline connections

```
USAGE
  $ agentia cicd pipeline connection create --pipeline-id <value> [--json] [--connection-id <value>] [-f <value> | --branch <value> |
    --destination-branch <value> | --destination-environment-id <value> | --source-environment-id <value> |
    --stage-connection-id <value> | --sync-merge-state <value> | --sync-pull-state <value>]

FLAGS
  -f, --file=<value>                        Path to a JSON array of pipeline connections to create
      --branch=<value>                      Source branch for the connection
      --connection-id=<value>               Pipeline connection ID (required for single-connection update or delete)
      --destination-branch=<value>          Destination branch for the connection
      --destination-environment-id=<value>  Destination environment ID
      --pipeline-id=<value>                 (required) Pipeline ID or name
      --source-environment-id=<value>       Source environment ID
      --stage-connection-id=<value>         Stage connection ID
      --sync-merge-state=<value>            Sync merge state
      --sync-pull-state=<value>             Sync pull state

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create one or more Copado pipeline connections

EXAMPLES
  $ agentia cicd pipeline connection create --pipeline-id pipeline-1 --source-environment-id env-1 --destination-environment-id env-2 --branch main

  $ agentia cicd pipeline connection create --pipeline-id pipeline-1 --file connections.json

  $ agentia cicd pipeline connection create --pipeline-id pipeline-1 --source-environment-id env-1 --destination-environment-id env-2 --branch main --json
```

_See code: [src/commands/cicd/pipeline/connection/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/connection/create.ts)_

## `agentia cicd pipeline connection delete`

Delete one or more Copado pipeline connections

```
USAGE
  $ agentia cicd pipeline connection delete --pipeline-id <value> [--json] [-f <value> | --connection-id <value>...]
  [-y]

FLAGS
  -f, --file=<value>              Path to a JSON array of connection IDs or an object with connectionIds
  -y, --yes                       Confirm deletion without prompting
      --connection-id=<value>...  Pipeline connection ID to delete (repeatable)
      --pipeline-id=<value>       (required) Pipeline ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete one or more Copado pipeline connections

EXAMPLES
  $ agentia cicd pipeline connection delete --pipeline-id pipeline-1 --connection-id conn-1 --yes

  $ agentia cicd pipeline connection delete --pipeline-id pipeline-1 --connection-id conn-1 --connection-id conn-2 --yes

  $ agentia cicd pipeline connection delete --pipeline-id pipeline-1 --file connection-ids.json --yes --json
```

_See code: [src/commands/cicd/pipeline/connection/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/connection/delete.ts)_

## `agentia cicd pipeline connection list`

List connections for a Copado pipeline

```
USAGE
  $ agentia cicd pipeline connection list --pipeline-id <value> [--json]

FLAGS
  --pipeline-id=<value>  (required) Pipeline Id whose connections should be listed

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List connections for a Copado pipeline

EXAMPLES
  $ agentia cicd pipeline connection list --pipeline-id <pipeline-id>

  $ agentia cicd pipeline connection list --pipeline-id <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/connection/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/connection/list.ts)_

## `agentia cicd pipeline connection open ID`

Open a Copado pipeline connection in the browser

```
USAGE
  $ agentia cicd pipeline connection open ID [--json]

ARGUMENTS
  ID  Pipeline connection ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado pipeline connection in the browser

EXAMPLES
  $ agentia cicd pipeline connection open <connection-id>

  $ agentia cicd pipeline connection open <connection-id> --json
```

_See code: [src/commands/cicd/pipeline/connection/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/connection/open.ts)_

## `agentia cicd pipeline connection update`

Update one or more Copado pipeline connections

```
USAGE
  $ agentia cicd pipeline connection update --pipeline-id <value> [--json] [-f <value> | --branch <value> | --connection-id <value> |
    --destination-branch <value> | --destination-environment-id <value> | --source-environment-id <value> |
    --stage-connection-id <value> | --sync-merge-state <value> | --sync-pull-state <value>]

FLAGS
  -f, --file=<value>                        Path to a JSON array of pipeline connections to update (each item requires
                                            id)
      --branch=<value>                      Source branch for the connection
      --connection-id=<value>               Pipeline connection ID (required for single-connection update or delete)
      --destination-branch=<value>          Destination branch for the connection
      --destination-environment-id=<value>  Destination environment ID
      --pipeline-id=<value>                 (required) Pipeline ID or name
      --source-environment-id=<value>       Source environment ID
      --stage-connection-id=<value>         Stage connection ID
      --sync-merge-state=<value>            Sync merge state
      --sync-pull-state=<value>             Sync pull state

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update one or more Copado pipeline connections

EXAMPLES
  $ agentia cicd pipeline connection update --pipeline-id pipeline-1 --connection-id conn-1 --destination-branch develop

  $ agentia cicd pipeline connection update --pipeline-id pipeline-1 --file connections.json

  $ agentia cicd pipeline connection update --pipeline-id pipeline-1 --connection-id conn-1 --branch main --json
```

_See code: [src/commands/cicd/pipeline/connection/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/connection/update.ts)_

## `agentia cicd pipeline create NAME`

Create a Copado pipeline

```
USAGE
  $ agentia cicd pipeline create NAME [--json] [--active] [--block-commits] [--enable-smart-conflict-resolution]
    [--calculate-based-on User Story|Branch] [--git-repository-id <value>] [--main-branch <value>] [--platform
    Salesforce|SFDX|Heroku|Mulesoft|Marketing|Other]

ARGUMENTS
  NAME  Name of the Copado pipeline to create

FLAGS
  --[no-]active                            Whether the pipeline is active
  --[no-]block-commits                     Block commits on the pipeline
  --calculate-based-on=<option>            Promotion calculation basis
                                           <options: User Story|Branch>
  --[no-]enable-smart-conflict-resolution  Enable smart conflict resolution
  --git-repository-id=<value>              Git repository ID
  --main-branch=<value>                    Main branch name
  --platform=<option>                      Pipeline platform
                                           <options: Salesforce|SFDX|Heroku|Mulesoft|Marketing|Other>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado pipeline

EXAMPLES
  $ agentia cicd pipeline create "Dev Pipeline"

  $ agentia cicd pipeline create "Dev Pipeline" --platform SFDX --main-branch main --active

  $ agentia cicd pipeline create "Dev Pipeline" --json
```

_See code: [src/commands/cicd/pipeline/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/create.ts)_

## `agentia cicd pipeline get ID`

Get a Copado pipeline

```
USAGE
  $ agentia cicd pipeline get ID [--json]

ARGUMENTS
  ID  Pipeline Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado pipeline

EXAMPLES
  $ agentia cicd pipeline get <pipeline-id>

  $ agentia cicd pipeline get <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/get.ts)_

## `agentia cicd pipeline list`

List Copado pipelines

```
USAGE
  $ agentia cicd pipeline list [--json] [--cursor <value>] [--page-size <value>] [--active] [--name <value>] [--platform
    Salesforce|SFDX|Heroku|Mulesoft|Marketing|Other]

FLAGS
  --[no-]active        Filter by active status
  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
  --name=<value>       Filter by pipeline name
  --page-size=<value>  Number of records per page (1-200)
  --platform=<option>  Filter by pipeline platform
                       <options: Salesforce|SFDX|Heroku|Mulesoft|Marketing|Other>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado pipelines

EXAMPLES
  $ agentia cicd pipeline list

  $ agentia cicd pipeline list --name "Dev Pipeline" --active --platform SFDX

  $ agentia cicd pipeline list --json
```

_See code: [src/commands/cicd/pipeline/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/list.ts)_

## `agentia cicd pipeline open ID`

Open a Copado pipeline in the browser

```
USAGE
  $ agentia cicd pipeline open ID [--json]

ARGUMENTS
  ID  Pipeline ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado pipeline in the browser

EXAMPLES
  $ agentia cicd pipeline open <pipeline-id>

  $ agentia cicd pipeline open <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/open.ts)_

## `agentia cicd pipeline quality-gate activate ID`

Activate a Copado pipeline quality gate

```
USAGE
  $ agentia cicd pipeline quality-gate activate ID --pipeline-id <value> [--json]

ARGUMENTS
  ID  Quality gate Salesforce ID (not name)

FLAGS
  --pipeline-id=<value>  (required) Pipeline ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Activate a Copado pipeline quality gate

EXAMPLES
  $ agentia cicd pipeline quality-gate activate <rule-id> --pipeline-id <pipeline-id>

  $ agentia cicd pipeline quality-gate activate <rule-id> --pipeline-id <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/quality-gate/activate.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/quality-gate/activate.ts)_

## `agentia cicd pipeline quality-gate create`

Create inactive Copado pipeline quality gates

```
USAGE
  $ agentia cicd pipeline quality-gate create --action <value> --execution-sequence Before|After --extension-configuration-id <value>
    --pipeline-id <value> --tool <value> [--json] [--entire-pipeline | --environment-id <value>... | --stage-id
    <value>...] [--filter-criteria <value> | --filter-criteria-file <value>] [--tests-from User
    Story|Feature|Application]

FLAGS
  --action=<value>
      (required) Pipeline action the gate runs for (for example Commit, Promotion, Deployment)

  --entire-pipeline
      Apply the quality gate to the entire pipeline (mutually exclusive with --stage-id/--environment-id)

  --environment-id=<value>...
      Environment ID target (repeatable; provide --entire-pipeline or at least one stage/environment target)

  --execution-sequence=<option>
      (required) When the gate runs relative to the action (Before, After)
      <options: Before|After>

  --extension-configuration-id=<value>
      (required) Active extension configuration ID whose tool matches --tool

  --filter-criteria=<value>
      Metadata-change filter as JSON. Limits which metadata changes trigger the gate. Example: '{"conditions":[{"field":"T
      ype","operator":"equals","value":"ApexClass"},{"field":"Name","operator":"startsWith","value":"Account"}],"logic":"1
      AND 2"}'. Fields: Name, Type, Directory. Operators: startsWith, endsWith, equals, notEquals, contains, notContains.
      logic is optional for a single condition; otherwise reference each condition number exactly once with AND/OR and
      parentheses.

  --filter-criteria-file=<value>
      Path to a JSON file with the metadata-change filter shape documented on --filter-criteria

  --pipeline-id=<value>
      (required) Pipeline ID or name

  --stage-id=<value>...
      Stage ID target (repeatable; provide --entire-pipeline or at least one stage/environment target)

  --tests-from=<option>
      Where selected tests come from when the tool supports it (User Story, Feature, Application)
      <options: User Story|Feature|Application>

  --tool=<value>
      (required) Quality gate tool name (must be available for the tenant and match the extension configuration)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create inactive Copado pipeline quality gates

EXAMPLES
  $ agentia cicd pipeline quality-gate create --pipeline-id <pipeline-id> --tool Selenium --execution-sequence After --action Deployment --extension-configuration-id <ext-conf-id> --environment-id <env-id> --tests-from "User Story"

  $ agentia cicd pipeline quality-gate create --pipeline-id <pipeline-id> --tool PMD --execution-sequence Before --action Commit --extension-configuration-id <ext-conf-id> --entire-pipeline --json

  $ agentia cicd pipeline quality-gate create --pipeline-id <pipeline-id> --tool PMD --execution-sequence Before --action Commit --extension-configuration-id <ext-conf-id> --stage-id <stage-id> --filter-criteria '{"conditions":[{"field":"Type","operator":"equals","value":"ApexClass"},{"field":"Name","operator":"startsWith","value":"Account"}],"logic":"1 AND 2"}'
```

_See code: [src/commands/cicd/pipeline/quality-gate/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/quality-gate/create.ts)_

## `agentia cicd pipeline quality-gate deactivate ID`

Deactivate a Copado pipeline quality gate

```
USAGE
  $ agentia cicd pipeline quality-gate deactivate ID --pipeline-id <value> [--json]

ARGUMENTS
  ID  Quality gate Salesforce ID (not name)

FLAGS
  --pipeline-id=<value>  (required) Pipeline ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Deactivate a Copado pipeline quality gate

EXAMPLES
  $ agentia cicd pipeline quality-gate deactivate <rule-id> --pipeline-id <pipeline-id>

  $ agentia cicd pipeline quality-gate deactivate <rule-id> --pipeline-id <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/quality-gate/deactivate.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/quality-gate/deactivate.ts)_

## `agentia cicd pipeline quality-gate delete ID`

Delete an inactive Copado pipeline quality gate

```
USAGE
  $ agentia cicd pipeline quality-gate delete ID --pipeline-id <value> [--json] [-y]

ARGUMENTS
  ID  Quality gate ID or name

FLAGS
  -y, --yes                  Confirm deletion without prompting
      --pipeline-id=<value>  (required) Pipeline ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete an inactive Copado pipeline quality gate

EXAMPLES
  $ agentia cicd pipeline quality-gate delete <rule-id> --pipeline-id <pipeline-id> --yes

  $ agentia cicd pipeline quality-gate delete <rule-id> --pipeline-id <pipeline-id> --yes --json
```

_See code: [src/commands/cicd/pipeline/quality-gate/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/quality-gate/delete.ts)_

## `agentia cicd pipeline quality-gate get ID`

Get a Copado pipeline quality gate

```
USAGE
  $ agentia cicd pipeline quality-gate get ID --pipeline-id <value> [--json]

ARGUMENTS
  ID  Quality gate ID or name

FLAGS
  --pipeline-id=<value>  (required) Pipeline ID or name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado pipeline quality gate

EXAMPLES
  $ agentia cicd pipeline quality-gate get <rule-id> --pipeline-id <pipeline-id>

  $ agentia cicd pipeline quality-gate get <rule-id> --pipeline-id <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/quality-gate/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/quality-gate/get.ts)_

## `agentia cicd pipeline quality-gate list`

List Copado pipeline quality gates

```
USAGE
  $ agentia cicd pipeline quality-gate list --pipeline-id <value> [--json] [--cursor <value>] [--page-size <value>] [--name <value>]
    [--tool <value>]

FLAGS
  --cursor=<value>       Opaque pagination cursor from a previous list response (nextCursor)
  --name=<value>         Filter by quality gate name
  --page-size=<value>    Number of records per page (1-200)
  --pipeline-id=<value>  (required) Pipeline ID or name
  --tool=<value>         Filter by quality gate tool

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado pipeline quality gates

EXAMPLES
  $ agentia cicd pipeline quality-gate list --pipeline-id <pipeline-id>

  $ agentia cicd pipeline quality-gate list --pipeline-id <pipeline-id> --tool Selenium --json
```

_See code: [src/commands/cicd/pipeline/quality-gate/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/quality-gate/list.ts)_

## `agentia cicd pipeline quality-gate open ID`

Open a Copado pipeline quality gate in the browser

```
USAGE
  $ agentia cicd pipeline quality-gate open ID [--json]

ARGUMENTS
  ID  Quality gate Salesforce ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado pipeline quality gate in the browser

EXAMPLES
  $ agentia cicd pipeline quality-gate open <rule-id>

  $ agentia cicd pipeline quality-gate open <rule-id> --json
```

_See code: [src/commands/cicd/pipeline/quality-gate/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/quality-gate/open.ts)_

## `agentia cicd pipeline quality-gate update ID`

Update an inactive Copado pipeline quality gate

```
USAGE
  $ agentia cicd pipeline quality-gate update ID --pipeline-id <value> [--json] [--action <value>] [--entire-pipeline]
    [--environment-id <value>] [--execution-sequence Before|After] [--extension-configuration-id <value>]
    [--filter-criteria <value> | --filter-criteria-file <value>] [--stage-id <value>] [--tests-from User
    Story|Feature|Application]

ARGUMENTS
  ID  Quality gate ID or name

FLAGS
  --action=<value>
      Pipeline action the gate runs for (for example Commit, Promotion, Deployment)

  --[no-]entire-pipeline
      Apply the quality gate to the entire pipeline (mutually exclusive with --stage-id/--environment-id)

  --environment-id=<value>
      Environment ID target (singular for update)

  --execution-sequence=<option>
      When the gate runs relative to the action (Before, After)
      <options: Before|After>

  --extension-configuration-id=<value>
      Active extension configuration ID whose tool matches the gate tool

  --filter-criteria=<value>
      Metadata-change filter as JSON. Limits which metadata changes trigger the gate. Example: '{"conditions":[{"field":"T
      ype","operator":"equals","value":"ApexClass"},{"field":"Name","operator":"startsWith","value":"Account"}],"logic":"1
      AND 2"}'. Fields: Name, Type, Directory. Operators: startsWith, endsWith, equals, notEquals, contains, notContains.
      logic is optional for a single condition; otherwise reference each condition number exactly once with AND/OR and
      parentheses.

  --filter-criteria-file=<value>
      Path to a JSON file with the metadata-change filter shape documented on --filter-criteria

  --pipeline-id=<value>
      (required) Pipeline ID or name

  --stage-id=<value>
      Stage ID target (singular for update)

  --tests-from=<option>
      Where selected tests come from when the tool supports it (User Story, Feature, Application)
      <options: User Story|Feature|Application>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update an inactive Copado pipeline quality gate

EXAMPLES
  $ agentia cicd pipeline quality-gate update <rule-id> --pipeline-id <pipeline-id> --execution-sequence Before

  $ agentia cicd pipeline quality-gate update <rule-id> --pipeline-id <pipeline-id> --environment-id <env-id> --json
```

_See code: [src/commands/cicd/pipeline/quality-gate/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/quality-gate/update.ts)_

## `agentia cicd pipeline stage-connection create`

Create a pipeline stage connection

```
USAGE
  $ agentia cicd pipeline stage-connection create --pipeline-id <value> [--json] [--next-pipeline-stage-connection-id <value>] [--stage-id
    <value>]

FLAGS
  --next-pipeline-stage-connection-id=<value>  Next pipeline stage connection ID
  --pipeline-id=<value>                        (required) Pipeline ID
  --stage-id=<value>                           Stage ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a pipeline stage connection

EXAMPLES
  $ agentia cicd pipeline stage-connection create --pipeline-id pipeline-1 --stage-id stage-1
```

_See code: [src/commands/cicd/pipeline/stage-connection/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/stage-connection/create.ts)_

## `agentia cicd pipeline stage-connection delete ID`

Delete a pipeline stage connection

```
USAGE
  $ agentia cicd pipeline stage-connection delete ID --pipeline-id <value> [--json] [-y]

ARGUMENTS
  ID  Pipeline stage connection ID

FLAGS
  -y, --yes                  Confirm deletion without prompting
      --pipeline-id=<value>  (required) Pipeline ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a pipeline stage connection

EXAMPLES
  $ agentia cicd pipeline stage-connection delete connection-1 --pipeline-id pipeline-1 --yes
```

_See code: [src/commands/cicd/pipeline/stage-connection/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/stage-connection/delete.ts)_

## `agentia cicd pipeline stage-connection list`

List stage connections for a Copado pipeline

```
USAGE
  $ agentia cicd pipeline stage-connection list --pipeline-id <value> [--json]

FLAGS
  --pipeline-id=<value>  (required) Pipeline ID whose stage connections should be listed

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List stage connections for a Copado pipeline

EXAMPLES
  $ agentia cicd pipeline stage-connection list --pipeline-id <pipeline-id>

  $ agentia cicd pipeline stage-connection list --pipeline-id <pipeline-id> --json
```

_See code: [src/commands/cicd/pipeline/stage-connection/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/stage-connection/list.ts)_

## `agentia cicd pipeline stage-connection open ID`

Open a pipeline stage connection in the browser

```
USAGE
  $ agentia cicd pipeline stage-connection open ID [--json]

ARGUMENTS
  ID  Pipeline stage connection ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a pipeline stage connection in the browser

EXAMPLES
  $ agentia cicd pipeline stage-connection open connection-1

  $ agentia cicd pipeline stage-connection open connection-1 --json
```

_See code: [src/commands/cicd/pipeline/stage-connection/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/stage-connection/open.ts)_

## `agentia cicd pipeline stage-connection update ID`

Update a pipeline stage connection

```
USAGE
  $ agentia cicd pipeline stage-connection update ID --pipeline-id <value> [--json] [--next-pipeline-stage-connection-id <value>]
    [--stage-id <value>]

ARGUMENTS
  ID  Pipeline stage connection ID

FLAGS
  --next-pipeline-stage-connection-id=<value>  Next pipeline stage connection ID
  --pipeline-id=<value>                        (required) Pipeline ID
  --stage-id=<value>                           Stage ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a pipeline stage connection

EXAMPLES
  $ agentia cicd pipeline stage-connection update connection-1 --pipeline-id pipeline-1 --next-pipeline-stage-connection-id connection-2
```

_See code: [src/commands/cicd/pipeline/stage-connection/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/stage-connection/update.ts)_

## `agentia cicd pipeline update ID`

Update a Copado pipeline by ID

```
USAGE
  $ agentia cicd pipeline update ID [--json] [--active] [--block-commits] [--enable-smart-conflict-resolution]
    [--calculate-based-on User Story|Branch] [--git-repository-id <value>] [--main-branch <value>] [--platform
    Salesforce|SFDX|Heroku|Mulesoft|Marketing|Other] [--name <value>]

ARGUMENTS
  ID  Pipeline ID

FLAGS
  --[no-]active                            Whether the pipeline is active
  --[no-]block-commits                     Block commits on the pipeline
  --calculate-based-on=<option>            Promotion calculation basis
                                           <options: User Story|Branch>
  --[no-]enable-smart-conflict-resolution  Enable smart conflict resolution
  --git-repository-id=<value>              Git repository ID
  --main-branch=<value>                    Main branch name
  --name=<value>                           Pipeline name
  --platform=<option>                      Pipeline platform
                                           <options: Salesforce|SFDX|Heroku|Mulesoft|Marketing|Other>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado pipeline by ID

EXAMPLES
  $ agentia cicd pipeline update pipeline-1 --main-branch develop

  $ agentia cicd pipeline update pipeline-1 --platform SFDX --active

  $ agentia cicd pipeline update pipeline-1 --name "Updated Pipeline" --json
```

_See code: [src/commands/cicd/pipeline/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/pipeline/update.ts)_

## `agentia cicd project create NAME`

Create a Copado project

```
USAGE
  $ agentia cicd project create NAME [--json] [--description <value>] [--end-date <value>] [--pipeline <value>]
    [--should-index-metadata] [--start-date <value>] [--status <value>]

ARGUMENTS
  NAME  Copado project name

FLAGS
  --description=<value>         Project description
  --end-date=<value>            Project end date (YYYY-MM-DD)
  --pipeline=<value>            Pipeline ID
  --[no-]should-index-metadata  Whether project metadata should be indexed
  --start-date=<value>          Project start date (YYYY-MM-DD)
  --status=<value>              Project status

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado project

EXAMPLES
  $ agentia cicd project create "Release Project"

  $ agentia cicd project create "Release Project" --pipeline pipeline-1 --json
```

_See code: [src/commands/cicd/project/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/project/create.ts)_

## `agentia cicd project default get`

Show project default values for the current project or globally

```
USAGE
  $ agentia cicd project default get [--json] [--assign-me] [--credential] [--environment] [--epic] [--feature] [--global]
    [--project] [--sprint] [--team]

FLAGS
  --assign-me    Select the assign-me default
  --credential   Select the default source credential
  --environment  Select the default environment
  --epic         Select the default epic
  --feature      Select the default feature
  --global       Use machine-wide defaults instead of project-local defaults
  --project      Select the default project
  --sprint       Select the default sprint
  --team         Select the default team

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show project default values for the current project or globally

EXAMPLES
  $ agentia cicd project default get

  $ agentia cicd project default get --project --environment

  $ agentia cicd project default get --global

  $ agentia cicd project default get --json
```

_See code: [src/commands/cicd/project/default/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/project/default/get.ts)_

## `agentia cicd project default set`

Set project default values for the current project or globally

```
USAGE
  $ agentia cicd project default set [--json] [--credential <value>] [--environment <value>] [--epic <value>] [--feature
    <value>] [--project <value>] [--sprint <value>] [--team <value>] [--assign-me] [--global]

FLAGS
  --assign-me            Assign work items to the current user by default
  --credential=<value>   Default source credential
  --environment=<value>  Default environment
  --epic=<value>         Default epic
  --feature=<value>      Default feature
  --global               Use machine-wide defaults instead of project-local defaults
  --project=<value>      Default project
  --sprint=<value>       Default sprint
  --team=<value>         Default team

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Set project default values for the current project or globally

EXAMPLES
  $ agentia cicd project default set --project my-project --team platform

  $ agentia cicd project default set --environment dev --assign-me

  $ agentia cicd project default set --project my-project --global

  $ agentia cicd project default set --project my-project --json
```

_See code: [src/commands/cicd/project/default/set.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/project/default/set.ts)_

## `agentia cicd project default unset`

Remove project default values from the current project or globally

```
USAGE
  $ agentia cicd project default unset [--json] [--assign-me] [--credential] [--environment] [--epic] [--feature] [--global]
    [--project] [--sprint] [--team]

FLAGS
  --assign-me    Select the assign-me default
  --credential   Select the default source credential
  --environment  Select the default environment
  --epic         Select the default epic
  --feature      Select the default feature
  --global       Use machine-wide defaults instead of project-local defaults
  --project      Select the default project
  --sprint       Select the default sprint
  --team         Select the default team

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Remove project default values from the current project or globally

EXAMPLES
  $ agentia cicd project default unset --project

  $ agentia cicd project default unset --environment --team

  $ agentia cicd project default unset --assign-me --global

  $ agentia cicd project default unset --project --json
```

_See code: [src/commands/cicd/project/default/unset.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/project/default/unset.ts)_

## `agentia cicd project delete ID`

Delete a Copado project by ID

```
USAGE
  $ agentia cicd project delete ID [--json] [-y]

ARGUMENTS
  ID  Copado project ID

FLAGS
  -y, --yes  Confirm deletion without prompting

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado project by ID

EXAMPLES
  $ agentia cicd project delete project-1 --yes

  $ agentia cicd project delete project-1 --yes --json
```

_See code: [src/commands/cicd/project/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/project/delete.ts)_

## `agentia cicd project get ID`

Get a Copado project by ID

```
USAGE
  $ agentia cicd project get ID [--json]

ARGUMENTS
  ID  Copado project ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado project by ID

EXAMPLES
  $ agentia cicd project get <project-id>

  $ agentia cicd project get <project-id> --json
```

_See code: [src/commands/cicd/project/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/project/get.ts)_

## `agentia cicd project list`

List Copado projects

```
USAGE
  $ agentia cicd project list [--json] [--cursor <value>] [--page-size <value>] [--end-date-from <value>]
    [--end-date-to <value>] [--mine] [--name <value>] [--start-date-from <value>] [--start-date-to <value>] [--status
    <value>]

FLAGS
  --cursor=<value>           Opaque pagination cursor from a previous list response (nextCursor)
  --end-date-from=<value>    Filter by end date (inclusive, YYYY-MM-DD)
  --end-date-to=<value>      Filter by end date (inclusive, YYYY-MM-DD)
  --mine                     List only projects owned by or related to the current user
  --name=<value>             Filter by name (partial match)
  --page-size=<value>        Number of records per page (1-200)
  --start-date-from=<value>  Filter by start date (inclusive, YYYY-MM-DD)
  --start-date-to=<value>    Filter by start date (inclusive, YYYY-MM-DD)
  --status=<value>           Filter by project status

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado projects

EXAMPLES
  $ agentia cicd project list

  $ agentia cicd project list --mine

  $ agentia cicd project list --name Gateway

  $ agentia cicd project list --mine --json
```

_See code: [src/commands/cicd/project/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/project/list.ts)_

## `agentia cicd project open [ID]`

Open a Copado project in the browser

```
USAGE
  $ agentia cicd project open [ID] [--json]

ARGUMENTS
  [ID]  Copado project ID (defaults to the configured project default)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado project in the browser

EXAMPLES
  $ agentia cicd project open

  $ agentia cicd project open a0wKC000000CmZ2AU

  $ agentia cicd project open a0wKC000000CmZ2AU --json
```

_See code: [src/commands/cicd/project/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/project/open.ts)_

## `agentia cicd project update ID`

Update a Copado project by ID

```
USAGE
  $ agentia cicd project update ID [--json] [--description <value>] [--end-date <value>] [--pipeline <value>]
    [--should-index-metadata] [--start-date <value>] [--status <value>] [--name <value>]

ARGUMENTS
  ID  Copado project ID

FLAGS
  --description=<value>         Project description
  --end-date=<value>            Project end date (YYYY-MM-DD)
  --name=<value>                Project name
  --pipeline=<value>            Pipeline ID
  --[no-]should-index-metadata  Whether project metadata should be indexed
  --start-date=<value>          Project start date (YYYY-MM-DD)
  --status=<value>              Project status

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado project by ID

EXAMPLES
  $ agentia cicd project update project-1 --name "Updated Project"

  $ agentia cicd project update project-1 --status Active --json
```

_See code: [src/commands/cicd/project/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/project/update.ts)_

## `agentia cicd promotion conflict get ID`

Get raw merge-conflict content for a promotion file

```
USAGE
  $ agentia cicd promotion conflict get ID -p <value> [--json] [--output <value>]

ARGUMENTS
  ID  Conflict attachment Id

FLAGS
  -p, --promotion=<value>  (required) Copado promotion Id
      --output=<value>     Write raw conflict content to this file path

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get raw merge-conflict content for a promotion file

EXAMPLES
  $ agentia cicd promotion conflict get <conflict-id> --promotion <promotion-id>

  $ agentia cicd promotion conflict get <conflict-id> -p <promotion-id> --output ./MyClass.cls

  $ agentia cicd promotion conflict get <conflict-id> -p <promotion-id> --json
```

_See code: [src/commands/cicd/promotion/conflict/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/promotion/conflict/get.ts)_

## `agentia cicd promotion conflict list`

List merge conflicts for a Copado promotion

```
USAGE
  $ agentia cicd promotion conflict list -p <value> [--json]

FLAGS
  -p, --promotion=<value>  (required) Copado promotion Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List merge conflicts for a Copado promotion

EXAMPLES
  $ agentia cicd promotion conflict list --promotion <promotion-id>

  $ agentia cicd promotion conflict list -p <promotion-id> --json
```

_See code: [src/commands/cicd/promotion/conflict/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/promotion/conflict/list.ts)_

## `agentia cicd promotion conflict resolve ID`

Resolve a promotion merge conflict automatically or from a file

```
USAGE
  $ agentia cicd promotion conflict resolve ID --mode auto|manual -p <value> [--json] [--file <value>]

ARGUMENTS
  ID  Conflict attachment Id

FLAGS
  -p, --promotion=<value>  (required) Copado promotion Id
      --file=<value>       Path to manually resolved conflict content
      --mode=<option>      (required) Conflict resolution mode
                           <options: auto|manual>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Resolve a promotion merge conflict automatically or from a file

EXAMPLES
  $ agentia cicd promotion conflict resolve <conflict-id> --promotion <promotion-id> --mode auto

  $ agentia cicd promotion conflict resolve <conflict-id> -p <promotion-id> --mode manual --file ./MyClass.cls

  $ agentia cicd promotion conflict resolve <conflict-id> -p <promotion-id> --mode auto --json
```

_See code: [src/commands/cicd/promotion/conflict/resolve.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/promotion/conflict/resolve.ts)_

## `agentia cicd promotion conflict unresolve ID`

Undo a promotion conflict resolution

```
USAGE
  $ agentia cicd promotion conflict unresolve ID -p <value> [--json]

ARGUMENTS
  ID  Conflict attachment Id

FLAGS
  -p, --promotion=<value>  (required) Copado promotion Id

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Undo a promotion conflict resolution

EXAMPLES
  $ agentia cicd promotion conflict unresolve <conflict-id> --promotion <promotion-id>

  $ agentia cicd promotion conflict unresolve <conflict-id> -p <promotion-id> --json
```

_See code: [src/commands/cicd/promotion/conflict/unresolve.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/promotion/conflict/unresolve.ts)_

## `agentia cicd promotion get ID`

Get a Copado promotion by ID

```
USAGE
  $ agentia cicd promotion get ID [--json]

ARGUMENTS
  ID  Copado promotion ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado promotion by ID

EXAMPLES
  $ agentia cicd promotion get <promotion-id>

  $ agentia cicd promotion get <promotion-id> --json
```

_See code: [src/commands/cicd/promotion/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/promotion/get.ts)_

## `agentia cicd promotion job-step update ID`

Update a promotion manual task

```
USAGE
  $ agentia cicd promotion job-step update ID -p <value> [--json] [--assignee-id <value>] [--assignee-name <value>] [--status
    Complete|Incomplete|Pending] [--task-comments <value>] [--task-description <value>]

ARGUMENTS
  ID  Promotion job step ID

FLAGS
  -p, --promotion=<value>         (required) Copado promotion ID or name
      --assignee-id=<value>       Salesforce user ID assigned to the manual task
      --assignee-name=<value>     Name of the user assigned to the manual task
      --status=<option>           Manual task status
                                  <options: Complete|Incomplete|Pending>
      --task-comments=<value>     Manual task comments
      --task-description=<value>  Manual task description

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a promotion manual task

EXAMPLES
  $ agentia cicd promotion job-step update <job-step-id> --promotion <promotion-id> --status Complete

  $ agentia cicd promotion job-step update <job-step-id> -p <promotion-name> --task-comments "Completed by QA"

  $ agentia cicd promotion job-step update <job-step-id> -p <promotion-id> --assignee-id 005... --assignee-name "Jane Doe" --json
```

_See code: [src/commands/cicd/promotion/job-step/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/promotion/job-step/update.ts)_

## `agentia cicd promotion list`

List Copado promotions

```
USAGE
  $ agentia cicd promotion list [--json] [--cursor <value>] [--page-size <value>] [--created-by-id <value>]
    [--created-by-name <value>] [--destination-environment-id <value>] [--destination-environment-name <value>]
    [--is-back-promotion] [--name <value>] [--pipeline-id <value>] [--pipeline-name <value>] [--project-id <value>]
    [--project-name <value>] [--source-environment-id <value>] [--source-environment-name <value>] [--status <value>]
    [--work-id <value>]

FLAGS
  --created-by-id=<value>                 Filter by creator ID
  --created-by-name=<value>               Filter by creator name
  --cursor=<value>                        Opaque pagination cursor from a previous list response (nextCursor)
  --destination-environment-id=<value>    Filter by destination environment ID
  --destination-environment-name=<value>  Filter by destination environment name
  --[no-]is-back-promotion                Filter by back promotion
  --name=<value>                          Filter by name
  --page-size=<value>                     Number of records per page (1-200)
  --pipeline-id=<value>                   Filter by pipeline ID
  --pipeline-name=<value>                 Filter by pipeline name
  --project-id=<value>                    Filter by project ID
  --project-name=<value>                  Filter by project name
  --source-environment-id=<value>         Filter by source environment ID
  --source-environment-name=<value>       Filter by source environment name
  --status=<value>                        Filter by status
  --work-id=<value>                       Filter by user story ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado promotions

EXAMPLES
  $ agentia cicd promotion list

  $ agentia cicd promotion list --status Completed --project-name "My Project" --page-size 50

  $ agentia cicd promotion list --json
```

_See code: [src/commands/cicd/promotion/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/promotion/list.ts)_

## `agentia cicd promotion open ID`

Open a Copado promotion in the browser

```
USAGE
  $ agentia cicd promotion open ID [--json]

ARGUMENTS
  ID  Copado promotion ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado promotion in the browser

EXAMPLES
  $ agentia cicd promotion open <promotion-id>

  $ agentia cicd promotion open <promotion-id> --json
```

_See code: [src/commands/cicd/promotion/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/promotion/open.ts)_

## `agentia cicd promotion run ID`

Preflight, start, and optionally wait for a Copado promotion execution. Use --resume to continue an existing failed or conflict-resolved execution without starting a duplicate promotion.

```
USAGE
  $ agentia cicd promotion run ID [--json] [--deployment-step-id <value>...] [--ignored-metadata-json <value>]
    [--operation merge|merge_and_deploy] [--recreate-promotion-branch] [--resume <value>] [--wait] [--wait-timeout
    <value>] [-y]

ARGUMENTS
  ID  18-character Salesforce Promotion ID

FLAGS
  -y, --yes                            Confirm promotion branch recreation without prompting.
      --deployment-step-id=<value>...  Ordered deployment-step Salesforce ID. Can be provided multiple times.
      --ignored-metadata-json=<value>  JSON array to persist through ignored-metadata before starting the promotion.
      --operation=<option>             Promotion operation. Required unless --resume is used.
                                       <options: merge|merge_and_deploy>
      --recreate-promotion-branch      Recreate the promotion branch before execution. Requires confirmation or --yes.
      --resume=<value>                 Resume this existing JobExecution ID instead of calling the promotion run
                                       endpoint.
      --[no-]wait                      Poll promotion and deployment executions to terminal status.
      --wait-timeout=<value>           [default: 900] Maximum total seconds to wait for promotion and deployment
                                       executions.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Preflight, start, and optionally wait for a Copado promotion execution. Use --resume to continue an existing failed or
  conflict-resolved execution without starting a duplicate promotion.

EXAMPLES
  $ agentia cicd promotion run a0BXXXXXXXXXXXXXXX --operation merge

  $ agentia cicd promotion run a0BXXXXXXXXXXXXXXX --operation merge_and_deploy --json

  $ agentia cicd promotion run a0BXXXXXXXXXXXXXXX --resume a4NXXXXXXXXXXXXXXX
```

_See code: [src/commands/cicd/promotion/run.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/promotion/run.ts)_

## `agentia cicd repository auth https configure ID`

Configure HTTPS authentication. Use a personal access token as the password when required by the provider.

```
USAGE
  $ agentia cicd repository auth https configure ID [--json] [--input-stdin] [--overwrite]

ARGUMENTS
  ID  Copado Git repository ID

FLAGS
  --input-stdin  Read the complete HTTPS authentication JSON payload from stdin
  --overwrite    Replace an existing validated HTTPS credential

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Configure HTTPS authentication. Use a personal access token as the password when required by the provider.
```

_See code: [src/commands/cicd/repository/auth/https/configure.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/auth/https/configure.ts)_

## `agentia cicd repository auth oauth login ID`

Authenticate a repository through browser OAuth and select a remote repository

```
USAGE
  $ agentia cicd repository auth oauth login ID [--json] [--port <value>] [--timeout <value>]

ARGUMENTS
  ID  Copado Git repository ID

FLAGS
  --port=<value>     Local callback port (default: scan 8080-8090)
  --timeout=<value>  [default: 300] Seconds to wait for browser authentication

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Authenticate a repository through browser OAuth and select a remote repository
```

_See code: [src/commands/cicd/repository/auth/oauth/login.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/auth/oauth/login.ts)_

## `agentia cicd repository auth setup ID`

Interactively configure repository authentication; OAuth is selected by default

```
USAGE
  $ agentia cicd repository auth setup ID [--json] [--overwrite]

ARGUMENTS
  ID  Copado Git repository ID

FLAGS
  --overwrite  Replace an existing HTTPS or SSH credential

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Interactively configure repository authentication; OAuth is selected by default
```

_See code: [src/commands/cicd/repository/auth/setup.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/auth/setup.ts)_

## `agentia cicd repository auth ssh configure ID`

Generate SSH authentication and a public key. Add the key to your Git provider as a deploy, access, or SSH key.

```
USAGE
  $ agentia cicd repository auth ssh configure ID [--json] [--overwrite]

ARGUMENTS
  ID  Copado Git repository ID

FLAGS
  --overwrite  Replace an existing SSH key after confirmation

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Generate SSH authentication and a public key. Add the key to your Git provider as a deploy, access, or SSH key.
```

_See code: [src/commands/cicd/repository/auth/ssh/configure.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/auth/ssh/configure.ts)_

## `agentia cicd repository create NAME`

Create a Copado Git repository shell

```
USAGE
  $ agentia cicd repository create NAME --provider Github|Bitbucket|GitLab|Azure|Microsoft Team Service|Copado Version
    Control|Others [--json] [--allow-functions-git-cache] [--copado-tunnel-enabled] [--source-format Metadata|DX]

ARGUMENTS
  NAME  Name of the Copado Git repository to create

FLAGS
  --[no-]allow-functions-git-cache  Allow Functions Git cache for this repository
  --[no-]copado-tunnel-enabled      Enable Copado tunnel for this repository
  --provider=<option>               (required) Git repository provider
                                    <options: Github|Bitbucket|GitLab|Azure|Microsoft Team Service|Copado Version
                                    Control|Others>
  --source-format=<option>          [default: DX] Git repository source format (default: DX)
                                    <options: Metadata|DX>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado Git repository shell

EXAMPLES
  $ agentia cicd repository create my-repo --source-format DX --provider Github

  $ agentia cicd repository create my-repo --source-format DX --provider GitLab --json
```

_See code: [src/commands/cicd/repository/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/create.ts)_

## `agentia cicd repository delete ID`

Delete a Copado Git repository by ID

```
USAGE
  $ agentia cicd repository delete ID [--json]

ARGUMENTS
  ID  Copado Git repository ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado Git repository by ID

EXAMPLES
  $ agentia cicd repository delete repo-001

  $ agentia cicd repository delete repo-001 --json
```

_See code: [src/commands/cicd/repository/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/delete.ts)_

## `agentia cicd repository get ID`

Get a Copado Git repository by ID

```
USAGE
  $ agentia cicd repository get ID [--json]

ARGUMENTS
  ID  Copado Git repository ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado Git repository by ID

EXAMPLES
  $ agentia cicd repository get repo-001

  $ agentia cicd repository get repo-001 --json
```

_See code: [src/commands/cicd/repository/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/get.ts)_

## `agentia cicd repository list`

List Copado Git repositories

```
USAGE
  $ agentia cicd repository list [--json] [--cursor <value>] [--page-size <value>] [--name <value>] [--provider
    Github|Bitbucket|GitLab|Azure|Microsoft Team Service|Copado Version Control|Others] [--source-format Metadata|DX]

FLAGS
  --cursor=<value>          Opaque pagination cursor from a previous list response (nextCursor)
  --name=<value>            Filter by name
  --page-size=<value>       Number of records per page (1-200)
  --provider=<option>       Filter by Git repository provider
                            <options: Github|Bitbucket|GitLab|Azure|Microsoft Team Service|Copado Version
                            Control|Others>
  --source-format=<option>  Filter by Git repository source format
                            <options: Metadata|DX>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado Git repositories

EXAMPLES
  $ agentia cicd repository list

  $ agentia cicd repository list --page-size 50

  $ agentia cicd repository list --cursor NEXT --json

  $ agentia cicd repository list --name copado-demo --provider Github

  $ agentia cicd repository list --source-format DX --json
```

_See code: [src/commands/cicd/repository/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/list.ts)_

## `agentia cicd repository open ID`

Open a Copado Git repository in the browser

```
USAGE
  $ agentia cicd repository open ID [--json]

ARGUMENTS
  ID  Copado Git repository ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado Git repository in the browser

EXAMPLES
  $ agentia cicd repository open <repository-id>

  $ agentia cicd repository open <repository-id> --json
```

_See code: [src/commands/cicd/repository/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/open.ts)_

## `agentia cicd repository reset ID`

Reset a Copado Git repository and its authentication configuration

```
USAGE
  $ agentia cicd repository reset ID [--json] [-y]

ARGUMENTS
  ID  Copado Git repository ID

FLAGS
  -y, --yes  Confirm reset without prompting

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Reset a Copado Git repository and its authentication configuration

EXAMPLES
  $ agentia cicd repository reset repo-001 --yes

  $ agentia cicd repository reset repo-001 --yes --json
```

_See code: [src/commands/cicd/repository/reset.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/reset.ts)_

## `agentia cicd repository update ID`

Update a Copado Git repository by ID

```
USAGE
  $ agentia cicd repository update ID [--json] [--allow-functions-git-cache] [--copado-tunnel-enabled]
    [--clear-branch-base-url] [--clear-commit-base-url] [--clear-pull-request-base-url] [--clear-tag-base-url]
    [--clear-uri] [--branch-base-url <value>] [--commit-base-url <value>] [--pull-request-base-url <value>]
    [--tag-base-url <value>] [--uri <value>] [--name <value>] [--provider Github|Bitbucket|GitLab|Azure|Microsoft Team
    Service|Copado Version Control|Others] [--source-format Metadata|DX]

ARGUMENTS
  ID  Copado Git repository ID

FLAGS
  --[no-]allow-functions-git-cache  Allow Functions Git cache for this repository
  --branch-base-url=<value>         Base URL for repository branch links
  --clear-branch-base-url           Clear the repository branch base URL
  --clear-commit-base-url           Clear the repository commit base URL
  --clear-pull-request-base-url     Clear the repository pull request base URL
  --clear-tag-base-url              Clear the repository tag base URL
  --clear-uri                       Clear the repository clone URI
  --commit-base-url=<value>         Base URL for repository commit links
  --[no-]copado-tunnel-enabled      Enable Copado tunnel for this repository
  --name=<value>                    Repository name
  --provider=<option>               Git repository provider
                                    <options: Github|Bitbucket|GitLab|Azure|Microsoft Team Service|Copado Version
                                    Control|Others>
  --pull-request-base-url=<value>   Base URL for repository pull request links
  --source-format=<option>          Git repository source format
                                    <options: Metadata|DX>
  --tag-base-url=<value>            Base URL for repository tag links
  --uri=<value>                     Repository clone URI

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado Git repository by ID

EXAMPLES
  $ agentia cicd repository update repo-001 --uri https://github.com/org/repo.git

  $ agentia cicd repository update repo-001 --clear-uri

  $ agentia cicd repository update repo-001 --provider GitLab --json
```

_See code: [src/commands/cicd/repository/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/update.ts)_

## `agentia cicd repository validate ID`

Validate Copado Git repository authentication

```
USAGE
  $ agentia cicd repository validate ID [--json]

ARGUMENTS
  ID  Copado Git repository ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Validate Copado Git repository authentication

EXAMPLES
  $ agentia cicd repository validate repo-001

  $ agentia cicd repository validate repo-001 --json
```

_See code: [src/commands/cicd/repository/validate.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/repository/validate.ts)_

## `agentia cicd stage create NAME`

Create a Copado stage

```
USAGE
  $ agentia cicd stage create NAME [--json] [--meta-stage <value>] [--name <value>]

ARGUMENTS
  NAME  Stage name

FLAGS
  --meta-stage=<value>  Meta stage (common values: Build, Test, Production; custom values are allowed)
  --name=<value>        Stage name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado stage

EXAMPLES
  $ agentia cicd stage create Build

  $ agentia cicd stage create Test --meta-stage Test
```

_See code: [src/commands/cicd/stage/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/stage/create.ts)_

## `agentia cicd stage delete ID`

Delete a Copado stage

```
USAGE
  $ agentia cicd stage delete ID [--json] [-y]

ARGUMENTS
  ID  Stage ID

FLAGS
  -y, --yes  Confirm deletion without prompting

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado stage

EXAMPLES
  $ agentia cicd stage delete <stage-id>

  $ agentia cicd stage delete <stage-id> --yes --json
```

_See code: [src/commands/cicd/stage/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/stage/delete.ts)_

## `agentia cicd stage get ID`

Get a Copado stage

```
USAGE
  $ agentia cicd stage get ID [--json]

ARGUMENTS
  ID  Stage ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado stage

EXAMPLES
  $ agentia cicd stage get <stage-id>

  $ agentia cicd stage get <stage-id> --json
```

_See code: [src/commands/cicd/stage/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/stage/get.ts)_

## `agentia cicd stage list`

List Copado stages

```
USAGE
  $ agentia cicd stage list [--json] [--cursor <value>] [--page-size <value>]

FLAGS
  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
  --page-size=<value>  Number of records per page (1-200)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado stages

EXAMPLES
  $ agentia cicd stage list

  $ agentia cicd stage list --json
```

_See code: [src/commands/cicd/stage/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/stage/list.ts)_

## `agentia cicd stage open ID`

Open a Copado stage in the browser

```
USAGE
  $ agentia cicd stage open ID [--json]

ARGUMENTS
  ID  Stage ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado stage in the browser

EXAMPLES
  $ agentia cicd stage open <stage-id>

  $ agentia cicd stage open <stage-id> --json
```

_See code: [src/commands/cicd/stage/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/stage/open.ts)_

## `agentia cicd stage update ID`

Update a Copado stage

```
USAGE
  $ agentia cicd stage update ID [--json] [--meta-stage <value>] [--name <value>]

ARGUMENTS
  ID  Stage ID

FLAGS
  --meta-stage=<value>  Meta stage (common values: Build, Test, Production; custom values are allowed)
  --name=<value>        Stage name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado stage

EXAMPLES
  $ agentia cicd stage update <stage-id> --name QA

  $ agentia cicd stage update <stage-id> --meta-stage Test
```

_See code: [src/commands/cicd/stage/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/stage/update.ts)_

## `agentia cicd template defaults`

Scaffold default Copado Job Template metadata without writing to Salesforce (legacy create ≈ defaults --write)

```
USAGE
  $ agentia cicd template defaults --name <value> [--json] [--api-name <value>] [--output <value>] [--write]

FLAGS
  --api-name=<value>  Optional template API name for the scaffold (defaults to {name}_1 on the gateway)
  --name=<value>      (required) Template display name used to scaffold defaults
  --output=<value>    Write scaffold JSON to this path (implies a disk write)
  --write             Write scaffold JSON to copado/templates/{apiName}.metadata.json (legacy create)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Scaffold default Copado Job Template metadata without writing to Salesforce (legacy create ≈ defaults --write)

EXAMPLES
  $ agentia cicd template defaults --name MyTemplate

  $ agentia cicd template defaults --name MyTemplate --api-name MyTemplate_1 --write

  $ agentia cicd template defaults --name MyTemplate --output ./copado/templates/MyTemplate_1.metadata.json --json
```

_See code: [src/commands/cicd/template/defaults.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/template/defaults.ts)_

## `agentia cicd template delete API-NAME`

Delete a Copado Job Template by API name

```
USAGE
  $ agentia cicd template delete API-NAME [--json]

ARGUMENTS
  API-NAME  Template API name

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado Job Template by API name

EXAMPLES
  $ agentia cicd template delete MyTemplate_1

  $ agentia cicd template delete MyTemplate_1 --json
```

_See code: [src/commands/cicd/template/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/template/delete.ts)_

## `agentia cicd template get API-NAME`

Get a Copado Job Template by API name (legacy retrieve ≈ get --write)

```
USAGE
  $ agentia cicd template get API-NAME [--json] [--output <value>] [--write]

ARGUMENTS
  API-NAME  Template API name

FLAGS
  --output=<value>  Write retrieved template JSON to this path (implies a disk write)
  --write           Write retrieved JSON to copado/templates/{apiName}.metadata.json (legacy retrieve)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado Job Template by API name (legacy retrieve ≈ get --write)

EXAMPLES
  $ agentia cicd template get MyTemplate_1

  $ agentia cicd template get MyTemplate_1 --write

  $ agentia cicd template get MyTemplate_1 --json
```

_See code: [src/commands/cicd/template/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/template/get.ts)_

## `agentia cicd template list`

List Copado Job Templates

```
USAGE
  $ agentia cicd template list [--json] [--cursor <value>] [--page-size <value>] [--fetch-all] [--name <value>] [--type
    custom|all]

FLAGS
  --cursor=<value>     Opaque pagination cursor from a previous list response (nextCursor)
  --fetch-all          Fetch all matching templates (incompatible with --cursor on the gateway)
  --name=<value>       Filter by name substring
  --page-size=<value>  Number of records per page (1-200)
  --type=<option>      [default: custom] List Custom templates only, or all templates
                       <options: custom|all>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado Job Templates

EXAMPLES
  $ agentia cicd template list

  $ agentia cicd template list --type all

  $ agentia cicd template list --name Demo --page-size 50

  $ agentia cicd template list --fetch-all --json
```

_See code: [src/commands/cicd/template/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/template/list.ts)_

## `agentia cicd template upsert API-NAME`

Create or update a Copado Job Template by API name (legacy deploy ≈ upsert reading disk or --file)

```
USAGE
  $ agentia cicd template upsert API-NAME [--json] [--description <value>] [--file <value>] [--name <value>] [--steps-file
    <value>] [--type <value>] [--version <value>] [--volume-options <value>]

ARGUMENTS
  API-NAME  Template API name

FLAGS
  --description=<value>     Template description
  --file=<value>            Path to a JSON file with the full upsert payload (legacy deploy format accepted)
  --name=<value>            Template display name (defaults to the API name argument)
  --steps-file=<value>      Path to a JSON file containing the steps array
  --type=<value>            Template type (for example Custom)
  --version=<value>         Template version
  --volume-options=<value>  Template volume options as a JSON string or plain string

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create or update a Copado Job Template by API name (legacy deploy ≈ upsert reading disk or --file)

EXAMPLES
  $ agentia cicd template upsert MyTemplate_1

  $ agentia cicd template upsert MyTemplate_1 --file ./copado/templates/MyTemplate_1.metadata.json

  $ agentia cicd template upsert MyTemplate_1 --name "My Template" --steps-file ./steps.json --json
```

_See code: [src/commands/cicd/template/upsert.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/template/upsert.ts)_

## `agentia cicd user get`

Get a Copado user by ID (defaults to the authenticated user)

```
USAGE
  $ agentia cicd user get [--json] [--id <value>]

FLAGS
  --id=<value>  [default: me] User ID, or "me" for the authenticated user

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado user by ID (defaults to the authenticated user)

EXAMPLES
  $ agentia cicd user get

  $ agentia cicd user get --id me

  $ agentia cicd user get --id 005000000000000

  $ agentia cicd user get --json
```

_See code: [src/commands/cicd/user/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/user/get.ts)_

## `agentia cicd work ahead-behind [ENVIRONMENT]`

Compare user stories ahead of and behind the next pipeline environment. Resolves the project (and its pipeline) from the project default or --project, finds the unique next environment from pipeline connections for the given or default environment, then GET /agentia/headless/work/user-stories-ahead-behind.

```
USAGE
  $ agentia cicd work ahead-behind [ENVIRONMENT] [--json] [--project <value>]

ARGUMENTS
  [ENVIRONMENT]  Copado environment Id or name (defaults to the configured project default environment)

FLAGS
  --project=<value>  Copado project Id (defaults to the configured project default)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Compare user stories ahead of and behind the next pipeline environment. Resolves the project (and its pipeline) from
  the project default or --project, finds the unique next environment from pipeline connections for the given or default
  environment, then GET /agentia/headless/work/user-stories-ahead-behind.

EXAMPLES
  $ agentia cicd work ahead-behind

  $ agentia cicd work ahead-behind dev1

  $ agentia cicd work ahead-behind a0E... --project a0w...

  $ agentia cicd work ahead-behind --json
```

_See code: [src/commands/cicd/work/ahead-behind.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/ahead-behind.ts)_

## `agentia cicd work create`

Create a Copado user story

```
USAGE
  $ agentia cicd work create [--json] [--excluded-from-cbm] [--custom-field <value>...] [--actual-points <value>]
    [--planned-points <value>] [--priority <value>] [--acceptance-criteria <value>] [--as-a <value>] [--assignee
    <value>] [--cancellation-reason <value>] [--close-date <value>] [--epic <value>] [--feature <value>]
    [--functional-requirements <value>] [--owner-id <value>] [--project <value>] [--record-type <value>] [--release-id
    <value>] [--so-that <value>] [--source-credential <value>] [--source-environment <value>] [--sprint-id <value>]
    [--status <value>] [--team <value>] [--technical-specifications <value>] [--theme <value>] [--title <value>]
    [--want-to <value>]

FLAGS
  --acceptance-criteria=<value>       Acceptance criteria (maximum 255 characters)
  --actual-points=<value>             Actual points
  --as-a=<value>                      User story "as a" clause (maximum 255 characters)
  --assignee=<value>                  Assignee ID
  --cancellation-reason=<value>       Cancellation reason
  --close-date=<value>                Close date
  --custom-field=<value>...           Subscriber custom field as ApiName=value (string value). Repeat for multiple
                                      fields; duplicate apiNames are rejected.
  --epic=<value>                      Epic
  --[no-]excluded-from-cbm            Exclude from CBM
  --feature=<value>                   Feature
  --functional-requirements=<value>   Functional requirements (maximum 30000 characters)
  --owner-id=<value>                  Owner ID
  --planned-points=<value>            Planned points
  --priority=<value>                  Priority
  --project=<value>                   Project ID
  --record-type=<value>               Record type
  --release-id=<value>                Release ID
  --so-that=<value>                   User story "so that" clause (maximum 255 characters)
  --source-credential=<value>         Source credential ID. When set, sourceEnvironment is sent as null so Salesforce
                                      assigns the environment from the credential.
  --source-environment=<value>        Source environment ID. Ignored when --source-credential is also set.
  --sprint-id=<value>                 Sprint ID
  --status=<value>                    Status
  --team=<value>                      Team
  --technical-specifications=<value>  Technical specifications (maximum 30000 characters)
  --theme=<value>                     Theme
  --title=<value>                     Title (maximum 255 characters)
  --want-to=<value>                   User story "want to" clause (maximum 255 characters)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado user story

EXAMPLES
  $ agentia cicd work create --title "My story" --status Draft

  $ agentia cicd work create --title "My story" --custom-field JIRA_Key__c=CICD-1

  $ agentia cicd work create --title "My story" --json
```

_See code: [src/commands/cicd/work/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/create.ts)_

## `agentia cicd work delete ID`

Delete a Copado user story by ID

```
USAGE
  $ agentia cicd work delete ID [--json]

ARGUMENTS
  ID  User story ID

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado user story by ID

EXAMPLES
  $ agentia cicd work delete a0SKC000000CmZ2AU

  $ agentia cicd work delete a0SKC000000CmZ2AU --json
```

_See code: [src/commands/cicd/work/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/delete.ts)_

## `agentia cicd work deployment-step create`

Create a deployment step for a user story

```
USAGE
  $ agentia cicd work deployment-step create [--json] [--apex-script <value> | --apex-script-file <value>] [--assignee-id <value>]
    [--assignee-name <value>] [--config-file <value> | --config-json <value>] [--crt-run-on source|destination]
    [--crt-test-id <value>] [--custom-step-api-name <value> | --type Manual Task|Salesforce Flow|Function|Apex|Data Set
    - Salesforce|Data Template - Salesforce|Robotic Test] [--data-set-id <value>] [--data-template-id <value>]
    [--environment source|destination|both] [--flow-name <value>] [--function-name <value>] [--instructions <value>]
    [--interactive] [--name <value>] [--parameter <value>...] [--queue-name <value>] [--run-on-validation] [--sequence
    before|after] [--skip-back-promotion] [--skip-condition <value>] [--user-story <value>]

FLAGS
  --apex-script=<value>           Apex script for a guided Apex step
  --apex-script-file=<value>      Path to an Apex script for a guided Apex step
  --assignee-id=<value>           Manual Task assignee Salesforce user ID
  --assignee-name=<value>         Manual Task assignee display name
  --config-file=<value>           Path to deployment step config JSON
  --config-json=<value>           Inline deployment step config JSON
  --crt-run-on=<option>           Environment where the Robotic Test runs
                                  <options: source|destination>
  --crt-test-id=<value>           Robotic Test Salesforce ID
  --custom-step-api-name=<value>  Custom deployment step API name
  --data-set-id=<value>           Salesforce Data Set ID
  --data-template-id=<value>      Salesforce Data Template ID
  --environment=<option>          Manual Task execution environment
                                  <options: source|destination|both>
  --flow-name=<value>             Salesforce Flow API name
  --function-name=<value>         Function name
  --instructions=<value>          Manual Task instructions
  --interactive                   Prompt for the type and all required configuration
  --name=<value>                  Deployment step name
  --parameter=<value>...          Flow or Function parameter as name=value (repeatable)
  --queue-name=<value>            Queue name
  --[no-]run-on-validation        Run or skip the step during validation
  --sequence=<option>             Place the deployment step before or after deployment
                                  <options: before|after>
  --[no-]skip-back-promotion      Skip or include the step during back promotion
  --skip-condition=<value>        Deployment step skip condition
  --type=<option>                 Standard deployment step type
                                  <options: Manual Task|Salesforce Flow|Function|Apex|Data Set - Salesforce|Data
                                  Template - Salesforce|Robotic Test>
  --user-story=<value>            User story ID (defaults to the active work item from `work set`)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a deployment step for a user story

EXAMPLES
  $ agentia cicd work deployment-step create --interactive

  $ agentia cicd work deployment-step create --name "Run robotic smoke test" --type "Robotic Test" --crt-test-id a1t... --crt-run-on destination

  $ agentia cicd work deployment-step create --name "Run post-deploy flow" --type "Salesforce Flow" --sequence after --config-json '{"flowName":"Post_Deploy","parameters":[]}'

  $ agentia cicd work deployment-step create --name "Deploy Mule application" --custom-step-api-name Deploy_Mule --config-file config.json --json
```

_See code: [src/commands/cicd/work/deployment-step/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/deployment-step/create.ts)_

## `agentia cicd work deployment-step delete`

Delete a user story deployment step

```
USAGE
  $ agentia cicd work deployment-step delete --step <value> [--json] [--user-story <value>]

FLAGS
  --step=<value>        (required) Deployment step ID
  --user-story=<value>  User story ID (defaults to the active work item from `work set`)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a user story deployment step

EXAMPLES
  $ agentia cicd work deployment-step delete --step a2D...

  $ agentia cicd work deployment-step delete --step a2D... --user-story a16... --json
```

_See code: [src/commands/cicd/work/deployment-step/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/deployment-step/delete.ts)_

## `agentia cicd work deployment-step list`

List deployment steps for a user story

```
USAGE
  $ agentia cicd work deployment-step list [--json] [--user-story <value>]

FLAGS
  --user-story=<value>  User story ID (defaults to the active work item from `work set`)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List deployment steps for a user story

EXAMPLES
  $ agentia cicd work deployment-step list

  $ agentia cicd work deployment-step list --user-story a16P700000000001AAA --json
```

_See code: [src/commands/cicd/work/deployment-step/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/deployment-step/list.ts)_

## `agentia cicd work deployment-step reorder`

Replace the complete deployment step order

```
USAGE
  $ agentia cicd work deployment-step reorder [--json] [--file <value> | --stdin] [--user-story <value>]

FLAGS
  --file=<value>        Path to a complete deployment step order JSON file
  --stdin               Read the complete deployment step order from stdin
  --user-story=<value>  User story ID (defaults to the active work item from `work set`)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Replace the complete deployment step order

EXAMPLES
  $ agentia cicd work deployment-step reorder --file order.json

  cat order.json | agentia cicd work deployment-step reorder --stdin --json
```

_See code: [src/commands/cicd/work/deployment-step/reorder.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/deployment-step/reorder.ts)_

## `agentia cicd work deployment-step salesforce-flows`

List Salesforce Flows available to deployment steps in the Copado org

```
USAGE
  $ agentia cicd work deployment-step salesforce-flows [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Salesforce Flows available to deployment steps in the Copado org

EXAMPLES
  $ agentia cicd work deployment-step salesforce-flows

  $ agentia cicd work deployment-step salesforce-flows --json
```

_See code: [src/commands/cicd/work/deployment-step/salesforce-flows.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/deployment-step/salesforce-flows.ts)_

## `agentia cicd work deployment-step types`

List available deployment step types

```
USAGE
  $ agentia cicd work deployment-step types [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List available deployment step types

EXAMPLES
  $ agentia cicd work deployment-step types

  $ agentia cicd work deployment-step types --json
```

_See code: [src/commands/cicd/work/deployment-step/types.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/deployment-step/types.ts)_

## `agentia cicd work deployment-step update`

Update a user story deployment step

```
USAGE
  $ agentia cicd work deployment-step update --step <value> [--json] [--clear-queue-name | --queue-name <value>]
    [--clear-skip-condition | --skip-condition <value>] [--config-file <value> | --config-json <value>] [--name <value>]
    [--run-on-validation] [--skip-back-promotion] [--user-story <value>]

FLAGS
  --clear-queue-name          Clear the queue name
  --clear-skip-condition      Clear the skip condition
  --config-file=<value>       Path to deployment step config JSON
  --config-json=<value>       Inline deployment step config JSON
  --name=<value>              Deployment step name
  --queue-name=<value>        Queue name
  --[no-]run-on-validation    Run or skip the step during validation
  --[no-]skip-back-promotion  Skip or include the step during back promotion
  --skip-condition=<value>    Deployment step skip condition
  --step=<value>              (required) Deployment step ID
  --user-story=<value>        User story ID (defaults to the active work item from `work set`)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a user story deployment step

EXAMPLES
  $ agentia cicd work deployment-step update --step a2D... --name "Updated step"

  $ agentia cicd work deployment-step update --step a2D... --clear-queue-name --json
```

_See code: [src/commands/cicd/work/deployment-step/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/deployment-step/update.ts)_

## `agentia cicd work done`

Alias of cicd work submit --done. Matches Copado UI Submit when promoting (not validate-only). Prefer: agentia cicd work submit --done.

```
USAGE
  $ agentia cicd work done [--json] [--skip-nested-metadata-detection]

FLAGS
  --skip-nested-metadata-detection  Do not detect the nested metadata changed across the branch when pushing (also
                                    configurable via skipNestedMetadataDetection in .agentia/config.json or
                                    .agentia/config.user.json)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Alias of cicd work submit --done. Matches Copado UI Submit when promoting (not validate-only). Prefer: agentia cicd
  work submit --done.

EXAMPLES
  $ agentia cicd work submit --done

  $ agentia cicd work done

  $ agentia cicd work done --skip-nested-metadata-detection

  $ agentia cicd work done --json
```

_See code: [src/commands/cicd/work/done.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/done.ts)_

## `agentia cicd work environment-sync`

Sync committed metadata from the next environment onto the destination environment (or current feature branch). Back-promotes every user story behind the destination environment from the next environment branch. GET user stories ahead and behind. If none are behind, log that and stop. Otherwise create a back-promotion and POST those behind stories onto the promotion. Resolves the next-environment Git branch from --destination-environment or --dev-org-branch (the dest pipeline connection destinationBranch, or that destination environment's outbound branch). Merges origin/<next-env> with --no-ff --no-commit, restores every other path from HEAD, commits the guessed pathspecs, and pushes the dest org branch (and the feature branch when HEAD starts with feature/). If guessed pathspecs still conflict, PATCH the back-promotion status to Merge Conflict, store lastEnvironmentSyncName, resolve the files, and re-run with --continue (optional --promotion). The promotion destination environment supplies the dest org branch and the next-env branch. To discard a conflicted merge, re-run with --abort (optional --promotion); runs git merge --abort and sets the back-promotion status to Draft. After a successful sync, PATCH the back-promotion status to Completed and clear lastEnvironmentSyncName. On git/merge failure (including conflicts) and after a successful --continue, uploads the captured command transcript as a Salesforce File on the back-promotion (`Environment Sync Logs <name-or-id> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not change the environment-sync outcome.

```
USAGE
  $ agentia cicd work environment-sync [--json] [--abort | --continue] [--destination-credential <value>]
    [--destination-environment <value> | --dev-org-branch <value>] [--pipeline-id <value>] [--promotion <value>]

FLAGS
  --abort                            Abort an in-progress merge (`git merge --abort`) and set the back-promotion status
                                     to Draft. Uses --promotion or lastEnvironmentSyncName. Exclusive with --continue.
  --continue                         Finish after merge conflicts. If the merge is still in progress (conflicts fixed
                                     and staged, but not committed), commits it; if you already committed, continues
                                     from there through the remaining git steps. Uses --promotion or
                                     lastEnvironmentSyncName.
  --destination-credential=<value>   Credential ID posted as destinationCredentialId when creating the back-promotion.
                                     Copado requires a credential on the next/source environment (PRO-033 if a dest/dev
                                     credential is sent) and then stores the dest/dev credential. Defaults to that
                                     source environment defaultCredential, otherwise the first source credential.
  --destination-environment=<value>  Destination org environment name or Id. Resolves to that environment's pipeline
                                     connection Git branch.
  --dev-org-branch=<value>           Destination org Git branch. Defaults to lastDevOrgBranch from `cicd work set`.
  --pipeline-id=<value>              Pipeline ID. Defaults to the active work item from `cicd work set`.
  --promotion=<value>                Back-promotion Id or name to PATCH when this run stops on merge conflicts, finishes
                                     successfully, continues, or aborts. Optional for --continue/--abort when
                                     lastEnvironmentSyncName was stored from a prior environment-sync run. Defaults to
                                     the back-promotion created in this run.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Sync committed metadata from the next environment onto the destination environment (or current feature branch).
  Back-promotes every user story behind the destination environment from the next environment branch. GET user stories
  ahead and behind. If none are behind, log that and stop. Otherwise create a back-promotion and POST those behind
  stories onto the promotion. Resolves the next-environment Git branch from --destination-environment or
  --dev-org-branch (the dest pipeline connection destinationBranch, or that destination environment's outbound branch).
  Merges origin/<next-env> with --no-ff --no-commit, restores every other path from HEAD, commits the guessed pathspecs,
  and pushes the dest org branch (and the feature branch when HEAD starts with feature/). If guessed pathspecs still
  conflict, PATCH the back-promotion status to Merge Conflict, store lastEnvironmentSyncName, resolve the files, and
  re-run with --continue (optional --promotion). The promotion destination environment supplies the dest org branch and
  the next-env branch. To discard a conflicted merge, re-run with --abort (optional --promotion); runs git merge --abort
  and sets the back-promotion status to Draft. After a successful sync, PATCH the back-promotion status to Completed and
  clear lastEnvironmentSyncName. On git/merge failure (including conflicts) and after a successful --continue, uploads
  the captured command transcript as a Salesforce File on the back-promotion (`Environment Sync Logs <name-or-id>
  <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other
  upload failures are warned and do not change the environment-sync outcome.

EXAMPLES
  $ agentia cicd work environment-sync --destination-environment=dev1

  $ agentia cicd work environment-sync --dev-org-branch=dev1-sfp

  $ agentia cicd work environment-sync --continue

  $ agentia cicd work environment-sync --abort

  $ agentia cicd work environment-sync --promotion=P29334 --continue

  $ agentia cicd work environment-sync --destination-environment=dev1 --json
```

_See code: [src/commands/cicd/work/environment-sync.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/environment-sync.ts)_

## `agentia cicd work get [ID]`

Get a Copado user story by ID

```
USAGE
  $ agentia cicd work get [ID] [--json] [--committed-metadata] [--user-stories-ahead-behind]

ARGUMENTS
  [ID]  User story ID (defaults to the active work item from `work set`)

FLAGS
  --committed-metadata         Also include the Story committed metadata list in output
  --user-stories-ahead-behind  When the user story has a pipeline and source environment, compare user stories ahead of
                               and behind the next pipeline environment

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado user story by ID

EXAMPLES
  $ agentia cicd work get

  $ agentia cicd work get a0SKC000000CmZ2AU

  $ agentia cicd work get a0SKC000000CmZ2AU --json

  $ agentia cicd work get a0SKC000000CmZ2AU --committed-metadata

  $ agentia cicd work get a0SKC000000CmZ2AU --committed-metadata --json

  $ agentia cicd work get a0SKC000000CmZ2AU --user-stories-ahead-behind

  $ agentia cicd work get a0SKC000000CmZ2AU --user-stories-ahead-behind --json
```

_See code: [src/commands/cicd/work/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/get.ts)_

## `agentia cicd work list`

List Copado user stories

```
USAGE
  $ agentia cicd work list [--json] [--cursor <value>] [--page-size <value>] [--assigned-to-me] [--assignee-id
    <value>] [--assignee-name <value>] [--name <value>] [--owned-by-me] [--owner-id <value>] [--owner-name <value>]
    [--project-id <value>] [--project-name <value>] [--status <value>] [--title <value>]

FLAGS
  --assigned-to-me         Filter by the current user as assignee
  --assignee-id=<value>    Filter by assignee ID
  --assignee-name=<value>  Filter by assignee name
  --cursor=<value>         Opaque pagination cursor from a previous list response (nextCursor)
  --name=<value>           Filter by name
  --owned-by-me            Filter by the current user as owner
  --owner-id=<value>       Filter by owner ID
  --owner-name=<value>     Filter by owner name
  --page-size=<value>      Number of records per page (1-200)
  --project-id=<value>     Filter by project ID
  --project-name=<value>   Filter by project name
  --status=<value>         Filter by status
  --title=<value>          Filter by title

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado user stories

EXAMPLES
  $ agentia cicd work list

  $ agentia cicd work list --status "In Progress" --project-name MyProject

  $ agentia cicd work list --assigned-to-me

  $ agentia cicd work list --owned-by-me

  $ agentia cicd work list --json
```

_See code: [src/commands/cicd/work/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/list.ts)_

## `agentia cicd work open [ID]`

Open a Copado user story in the browser

```
USAGE
  $ agentia cicd work open [ID] [--json]

ARGUMENTS
  [ID]  User story ID (defaults to the active work item from `work set`)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open a Copado user story in the browser

EXAMPLES
  $ agentia cicd work open

  $ agentia cicd work open a0SKC000000CmZ2AU

  $ agentia cicd work open a0SKC000000CmZ2AU --json
```

_See code: [src/commands/cicd/work/open.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/open.ts)_

## `agentia cicd work promote [USERSTORYIDS]`

Experimental: skips Quality Gates. Requires enableLocalPromote true in .agentia/config.json. Create a promotion for one or more user stories and merge each feature/<name> branch into promotion/<promotionName>. The promotion branch is created from the destination environment branch. Without --backpromote, the stories promote forward from their source environment to the next pipeline environment. With --backpromote, pass --destination-branch. The destination environment is the pipeline environment whose connection branch matches that name, and the source is the next environment above it. Story merges stop at the first conflict and the promotion status is set to Merge Conflict. Resolve those files, then re-run with --promotion=<name-or-id> --continue to commit the merge, merge any remaining stories, and finish the promotion. To discard a conflicted merge, re-run with --promotion=<name-or-id> --abort (runs git merge --abort and sets the promotion status to Draft). That continue command repeats --validate or --deploy and --sf-alias when the original command used them. After every story merges, the promotion branch is pushed. Without --validate or --deploy, the promotion status is set to Completed. With --validate or --deploy, --sf-alias is required. The command writes a temporary package.xml and postdestructivechanges.xml from the promotion metadata and runs sf project deploy start --test-level NoTestRun -o <alias>. --validate adds --dry-run, does not merge the destination branch, and sets the promotion status to Validated. --deploy merges the promotion branch into the destination branch and sets the promotion status to Completed only after that deployment succeeds. User story records are not updated.

```
USAGE
  $ agentia cicd work promote [USERSTORYIDS...] [--json] [--abort | --continue] [--deploy | --validate]
    [--destination-branch <value> --backpromote] [--destination-credential <value>] [--promotion <value>] [--sf-alias
    <value>]

ARGUMENTS
  [USERSTORYIDS...]  User story ID. Pass more than one to merge those feature branches in order. Omit when using
                     --promotion with --continue or --abort.

FLAGS
  --abort                           Abort an in-progress merge (`git merge --abort`) and set the promotion status to
                                    Draft. Requires --promotion. Exclusive with --continue.
  --backpromote                     Create a back promotion. Requires --destination-branch. Omit to promote forward to
                                    the next pipeline environment.
  --continue                        Commit a resolved merge on promotion/<name> and finish the remaining story merges.
                                    Requires --promotion.
  --deploy                          Deploy the promotion metadata with sf project deploy start, then merge the promotion
                                    branch into the destination branch and set the promotion status to Completed.
                                    Requires --sf-alias.
  --destination-branch=<value>      Destination environment Git branch for --backpromote. The destination environment is
                                    the pipeline environment whose connection branch matches this name.
  --destination-credential=<value>  Credential ID posted as destinationCredentialId. Defaults to the destination
                                    environment default credential for a forward promotion, or the next/source
                                    environment default credential for --backpromote.
  --promotion=<value>               Promotion Id or name for --continue after a merge conflict, or for --abort.
  --sf-alias=<value>                Salesforce org alias or username for --validate or --deploy. Passed to sf project
                                    deploy start -o.
  --validate                        Validate the promotion metadata with sf project deploy start --dry-run. Does not
                                    merge the destination branch. Sets the promotion status to Validated. Requires
                                    --sf-alias.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Experimental: skips Quality Gates. Requires enableLocalPromote true in .agentia/config.json. Create a promotion for
  one or more user stories and merge each feature/<name> branch into promotion/<promotionName>. The promotion branch is
  created from the destination environment branch. Without --backpromote, the stories promote forward from their source
  environment to the next pipeline environment. With --backpromote, pass --destination-branch. The destination
  environment is the pipeline environment whose connection branch matches that name, and the source is the next
  environment above it. Story merges stop at the first conflict and the promotion status is set to Merge Conflict.
  Resolve those files, then re-run with --promotion=<name-or-id> --continue to commit the merge, merge any remaining
  stories, and finish the promotion. To discard a conflicted merge, re-run with --promotion=<name-or-id> --abort (runs
  git merge --abort and sets the promotion status to Draft). That continue command repeats --validate or --deploy and
  --sf-alias when the original command used them. After every story merges, the promotion branch is pushed. Without
  --validate or --deploy, the promotion status is set to Completed. With --validate or --deploy, --sf-alias is required.
  The command writes a temporary package.xml and postdestructivechanges.xml from the promotion metadata and runs sf
  project deploy start --test-level NoTestRun -o <alias>. --validate adds --dry-run, does not merge the destination
  branch, and sets the promotion status to Validated. --deploy merges the promotion branch into the destination branch
  and sets the promotion status to Completed only after that deployment succeeds. User story records are not updated.

EXAMPLES
  $ agentia cicd work promote a16P7000006By3pIAC

  $ agentia cicd work promote a16P7000006By3pIAC a16P7000006By4qIAC

  $ agentia cicd work promote a16P7000006By3pIAC --backpromote --destination-branch dev1-sfp

  $ agentia cicd work promote a16P7000006By3pIAC --validate --sf-alias destOrg

  $ agentia cicd work promote a16P7000006By3pIAC --deploy --sf-alias destOrg

  $ agentia cicd work promote --promotion=P29354 --continue

  $ agentia cicd work promote --promotion=P29354 --abort

  $ agentia cicd work promote a16P7000006By3pIAC --json
```

_See code: [src/commands/cicd/work/promote.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/promote.ts)_

## `agentia cicd work publish`

Publish the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree, base branch, and dev org branch from `.agentia/config.user.json`. Fetches origin/<lastBaseBranch>, then registers only commits in origin/<lastBaseBranch>..HEAD and diffs nested parent XML at merge-base(origin/<lastBaseBranch>, HEAD) versus HEAD, so origin/base-only history is ignored. When there are no commits since origin/<lastBaseBranch>, or origin already has HEAD, fails with "No changes to publish" unless `--permissions` and/or `--full-metadata` is set, in which case it creates an empty commit so a tip commit id exists. Applies Copado environment-variable then yaml replacements to the added and modified files in origin/<lastBaseBranch>..HEAD (passed to the jars as `--include`; yaml `-b` is the feature branch, matching Copado Commit), commits both as a single follow-up commit, locks the tip commit, runs `git push origin <branch>`, reports the nested metadata changed across the branch, such as the CustomField behind a profile field-permission edit, plus the parent components it would ignore, calls headless work/push with one changeListUpdate list of Action:MetadataType:MetadataName corrections: lastPermissionSelected and --permissions plus the nested metadata of the changed profiles and permission sets as RetrieveOnly, lastFullMetadataSelected and --full-metadata plus brand-new nested parent files as fullMetadata, the ignored parents as unchanged, the nested metadata deleted on the branch as Delete, and the remaining nested metadata as Add, then merges the feature branch into the recorded dev org branch. The changed profiles and permission sets themselves are never sent as corrections, so they stay in the change list and deploy only the permissions their RetrieveOnly entries select. Brand-new nested parent files are an exception: they are sent as fullMetadata so the complete file travels. After a successful register, uploads the captured command output as a Salesforce File on the user story (`Local Commit Logs <commitId> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not fail the publish. `--dry-run` runs commit collection, replacements, and nested detection, logs the changeListUpdate that would be sent, skips empty/replacement commits, tip lock, git push, headless register, log upload, and dev-org sync, then restores only the tracked files dirtied by replacements (untracked files are left alone). `cicd work push` is a compatibility alias of this command.

```
USAGE
  $ agentia cicd work publish [--json] [--dry-run] [--full-metadata <value>] [--permissions <value>]
    [--skip-nested-metadata-detection]

FLAGS
  --dry-run
      Preview publish: run commit collection, Copado replacements, and nested metadata detection; log the changeListUpdate
      that would be registered; do not commit, push, lock, register, or sync the dev org branch. Restores dirtied tracked
      files afterward. Requires a clean tracked working tree.

  --full-metadata=<value>
      Comma-separated Type:Name metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding. Allowed types:
      Profile, PermissionSet, MutingPermissionSet, CustomObject, CustomObjectTranslation. Added for this publish and sent
      as headless push fullMetadata corrections. The named metadata is committed as a complete file, so it is never
      decomposed into nested metadata. Not stored.

  --permissions=<value>
      Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, added for this
      publish and sent as headless push RetrieveOnly corrections. Not stored.

  --skip-nested-metadata-detection
      Do not detect the nested metadata changed across the branch (also configurable via skipNestedMetadataDetection in
      .agentia/config.json or .agentia/config.user.json)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Publish the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree,
  base branch, and dev org branch from `.agentia/config.user.json`. Fetches origin/<lastBaseBranch>, then registers only
  commits in origin/<lastBaseBranch>..HEAD and diffs nested parent XML at merge-base(origin/<lastBaseBranch>, HEAD)
  versus HEAD, so origin/base-only history is ignored. When there are no commits since origin/<lastBaseBranch>, or
  origin already has HEAD, fails with "No changes to publish" unless `--permissions` and/or `--full-metadata` is set, in
  which case it creates an empty commit so a tip commit id exists. Applies Copado environment-variable then yaml
  replacements to the added and modified files in origin/<lastBaseBranch>..HEAD (passed to the jars as `--include`; yaml
  `-b` is the feature branch, matching Copado Commit), commits both as a single follow-up commit, locks the tip commit,
  runs `git push origin <branch>`, reports the nested metadata changed across the branch, such as the CustomField behind
  a profile field-permission edit, plus the parent components it would ignore, calls headless work/push with one
  changeListUpdate list of Action:MetadataType:MetadataName corrections: lastPermissionSelected and --permissions plus
  the nested metadata of the changed profiles and permission sets as RetrieveOnly, lastFullMetadataSelected and
  --full-metadata plus brand-new nested parent files as fullMetadata, the ignored parents as unchanged, the nested
  metadata deleted on the branch as Delete, and the remaining nested metadata as Add, then merges the feature branch
  into the recorded dev org branch. The changed profiles and permission sets themselves are never sent as corrections,
  so they stay in the change list and deploy only the permissions their RetrieveOnly entries select. Brand-new nested
  parent files are an exception: they are sent as fullMetadata so the complete file travels. After a successful
  register, uploads the captured command output as a Salesforce File on the user story (`Local Commit Logs <commitId>
  <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other
  upload failures are warned and do not fail the publish. `--dry-run` runs commit collection, replacements, and nested
  detection, logs the changeListUpdate that would be sent, skips empty/replacement commits, tip lock, git push, headless
  register, log upload, and dev-org sync, then restores only the tracked files dirtied by replacements (untracked files
  are left alone). `cicd work push` is a compatibility alias of this command.

  LOCAL DEVELOPMENT FLOW:

  # prepare feature branch from pipeline settings
  agentia cicd work set <user-story>

  # develop locally (retrieve/deploy to the Dev org as needed)
  git add … && git commit -m "<story> <message>"

  # optional: run local quality gates
  agentia cicd work test

  # push commits and register them in Copado
  agentia cicd work publish [--permissions=…] [--full-metadata=…]

  # validate and open the merge-request flow
  agentia cicd work submit [--skip-local-tests] [--skip-pull-request]

  # if warned about user stories ahead on the destination
  agentia cicd work environment-sync
  # after resolving pathspec conflicts (uses lastEnvironmentSyncName when set):
  agentia cicd work environment-sync --continue

  # when ready to promote and deploy
  agentia cicd work submit --done [--skip-local-tests] [--skip-pull-request]

EXAMPLES
  $ agentia cicd work publish

  $ agentia cicd work publish --dry-run

  $ agentia cicd work publish --permissions CustomField:Account.SLA__c,ApexClass:AccountService

  $ agentia cicd work publish --full-metadata PermissionSet:Sales_Onboarding

  $ agentia cicd work publish --skip-nested-metadata-detection

  $ agentia cicd work publish --json
```

_See code: [src/commands/cicd/work/publish.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/publish.ts)_

## `agentia cicd work push`

Alias of cicd work publish. Publishes the current feature/<lastWorkItem> branch and registers commits with Copado. Prefer: agentia cicd work publish.

```
USAGE
  $ agentia cicd work push [--json] [--dry-run] [--full-metadata <value>] [--permissions <value>]
    [--skip-nested-metadata-detection]

FLAGS
  --dry-run
      Preview publish: run commit collection, Copado replacements, and nested metadata detection; log the changeListUpdate
      that would be registered; do not commit, push, lock, register, or sync the dev org branch. Restores dirtied tracked
      files afterward. Requires a clean tracked working tree.

  --full-metadata=<value>
      Comma-separated Type:Name metadata such as Profile:Sales_User,PermissionSet:Sales_Onboarding. Allowed types:
      Profile, PermissionSet, MutingPermissionSet, CustomObject, CustomObjectTranslation. Added for this publish and sent
      as headless push fullMetadata corrections. The named metadata is committed as a complete file, so it is never
      decomposed into nested metadata. Not stored.

  --permissions=<value>
      Comma-separated type-prefixed metadata such as CustomField:Account.SLA__c,ApexClass:AccountService, added for this
      publish and sent as headless push RetrieveOnly corrections. Not stored.

  --skip-nested-metadata-detection
      Do not detect the nested metadata changed across the branch (also configurable via skipNestedMetadataDetection in
      .agentia/config.json or .agentia/config.user.json)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Alias of cicd work publish. Publishes the current feature/<lastWorkItem> branch and registers commits with Copado.
  Prefer: agentia cicd work publish.

EXAMPLES
  $ agentia cicd work publish

  $ agentia cicd work push

  $ agentia cicd work push --skip-nested-metadata-detection

  $ agentia cicd work push --json
```

_See code: [src/commands/cicd/work/push.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/push.ts)_

## `agentia cicd work set [ID]`

Set the active work item and prepare a local feature branch. Calls the CICD gateway work/set endpoint, requires a clean tracked working tree, fetches the work item base branch from origin, fetches the feature branch when it exists on origin, then creates or checks out feature/<user-story-name> from the remote feature branch when present, otherwise from the base branch. A gateway warning prints the message, skips git, clears lastBaseBranch/lastDevOrgBranch/lastPullRequestBaseUrl, and records lastWorkItemId/lastWorkItem/lastWorkItemTitle from the returned work item. After work/set returns, compares the Story source credential with the CICD project default: warns when the Story credential is missing, skips comparison when a bound Story has no project default, and warns without changing the Story when they differ (shows the current credential and environment; use work update to change it). With --none, clears every last* key from `.agentia/config.user.json` and checks out the previous lastBaseBranch when present, else main, else master, else stays put.

```
USAGE
  $ agentia cicd work set [ID] [--json] [--base-branch <value>] [--none]

ARGUMENTS
  [ID]  User story ID or name (omit with --none)

FLAGS
  --base-branch=<value>  Override the base branch returned by the work/set endpoint
  --none                 Clear every last* key from `.agentia/config.user.json` and check out lastBaseBranch, else main,
                         else master.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Set the active work item and prepare a local feature branch. Calls the CICD gateway work/set endpoint, requires a
  clean tracked working tree, fetches the work item base branch from origin, fetches the feature branch when it exists
  on origin, then creates or checks out feature/<user-story-name> from the remote feature branch when present, otherwise
  from the base branch. A gateway warning prints the message, skips git, clears
  lastBaseBranch/lastDevOrgBranch/lastPullRequestBaseUrl, and records lastWorkItemId/lastWorkItem/lastWorkItemTitle from
  the returned work item. After work/set returns, compares the Story source credential with the CICD project default:
  warns when the Story credential is missing, skips comparison when a bound Story has no project default, and warns
  without changing the Story when they differ (shows the current credential and environment; use work update to change
  it). With --none, clears every last* key from `.agentia/config.user.json` and checks out the previous lastBaseBranch
  when present, else main, else master, else stays put.

  LOCAL DEVELOPMENT FLOW:

  # prepare feature branch from pipeline settings
  agentia cicd work set <user-story>

  # develop locally (retrieve/deploy to the Dev org as needed)
  git add … && git commit -m "<story> <message>"

  # optional: run local quality gates
  agentia cicd work test

  # push commits and register them in Copado
  agentia cicd work publish [--permissions=…] [--full-metadata=…]

  # validate and open the merge-request flow
  agentia cicd work submit [--skip-local-tests] [--skip-pull-request]

  # if warned about user stories ahead on the destination
  agentia cicd work environment-sync
  # after resolving pathspec conflicts (uses lastEnvironmentSyncName when set):
  agentia cicd work environment-sync --continue

  # when ready to promote and deploy
  agentia cicd work submit --done [--skip-local-tests] [--skip-pull-request]

EXAMPLES
  $ agentia cicd work set a0SKC000000CmZ2AU

  $ agentia cicd work set US-0001 --json

  $ agentia cicd work set US-0001 --base-branch develop

  $ agentia cicd work set --none
```

_See code: [src/commands/cicd/work/set.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/set.ts)_

## `agentia cicd work status [ID]`

Get status for a work item, including related job executions. Includes local branch metadata when lastBaseBranch is recorded by `work set`. Uses the given user story ID/name, or the last work item from `agentia cicd work set`. Use --metadata-list-only to retrieve only local branch metadata without an API call.

```
USAGE
  $ agentia cicd work status [ID] [--json] [--metadata-list-only]

ARGUMENTS
  [ID]  User story ID or name (defaults to the last work item from `work set`)

FLAGS
  --metadata-list-only  Return only local branch metadata without calling the CICD API

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get status for a work item, including related job executions. Includes local branch metadata when lastBaseBranch is
  recorded by `work set`. Uses the given user story ID/name, or the last work item from `agentia cicd work set`. Use
  --metadata-list-only to retrieve only local branch metadata without an API call.

EXAMPLES
  $ agentia cicd work status

  $ agentia cicd work status US-0001

  $ agentia cicd work status a0SKC000000CmZ2AU --json

  $ agentia cicd work status --metadata-list-only
```

_See code: [src/commands/cicd/work/status.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/status.ts)_

## `agentia cicd work submit`

Submit the current feature/<lastWorkItem> work item for pipeline quality gates and validation. Runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present, pushes and registers commits when the branch is ahead of origin, then calls headless work/submit (Promote Action with validate=true). When the last pending related job template name contains Commit, waits up to 5 minutes for that job before submitting. Before submit or promote, counts user stories ahead and behind between the source environment and the next pipeline environment, and warns when stories behind might cause promotion conflicts (advising `agentia cicd work environment-sync`). After a successful submit or promote, uploads the captured command output as a Salesforce File on the user story (`Local Commit Logs <commitId> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not fail the command. With --done or --deploy, matches Copado UI Submit when promoting (validate=false / headless work/done). cicd work done is a compatibility alias of this command with --done.

```
USAGE
  $ agentia cicd work submit [--json] [--skip-nested-metadata-detection] [--apex-test-classes <value>] [--deploy]
    [--done] [--skip-local-tests] [--skip-pull-request]

FLAGS
  --apex-test-classes=<value>       Comma-separated Apex test class names passed to local quality gates as
                                    AGENTIA_APEX_TEST_CLASSES
  --deploy                          Alias of --done: promote instead of validate-only (Copado UI Submit promote)
  --done                            Promote instead of validate-only (Copado UI Submit promote); honors
                                    --skip-nested-metadata-detection. --deploy is an alias of --done.
  --skip-local-tests                Skip running local quality gates scripts in the project root
  --skip-nested-metadata-detection  Do not detect the nested metadata changed across the branch when pushing (also
                                    configurable via skipNestedMetadataDetection in .agentia/config.json or
                                    .agentia/config.user.json)
  --skip-pull-request               Do not open the pull request compare URL after submit (also configurable via
                                    skipPullRequest in .agentia/config.json or .agentia/config.user.json)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Submit the current feature/<lastWorkItem> work item for pipeline quality gates and validation. Runs project-root
  .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present, pushes and registers
  commits when the branch is ahead of origin, then calls headless work/submit (Promote Action with validate=true). When
  the last pending related job template name contains Commit, waits up to 5 minutes for that job before submitting.
  Before submit or promote, counts user stories ahead and behind between the source environment and the next pipeline
  environment, and warns when stories behind might cause promotion conflicts (advising `agentia cicd work
  environment-sync`). After a successful submit or promote, uploads the captured command output as a Salesforce File on
  the user story (`Local Commit Logs <commitId> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is
  ignored until that endpoint is rolled out; other upload failures are warned and do not fail the command. With --done
  or --deploy, matches Copado UI Submit when promoting (validate=false / headless work/done). cicd work done is a
  compatibility alias of this command with --done.

  LOCAL DEVELOPMENT FLOW:

  # prepare feature branch from pipeline settings
  agentia cicd work set <user-story>

  # develop locally (retrieve/deploy to the Dev org as needed)
  git add … && git commit -m "<story> <message>"

  # optional: run local quality gates
  agentia cicd work test

  # push commits and register them in Copado
  agentia cicd work publish [--permissions=…] [--full-metadata=…]

  # validate and open the merge-request flow
  agentia cicd work submit [--skip-local-tests] [--skip-pull-request]

  # if warned about user stories ahead on the destination
  agentia cicd work environment-sync
  # after resolving pathspec conflicts (uses lastEnvironmentSyncName when set):
  agentia cicd work environment-sync --continue

  # when ready to promote and deploy
  agentia cicd work submit --done [--skip-local-tests] [--skip-pull-request]

EXAMPLES
  $ agentia cicd work submit

  $ agentia cicd work submit --apex-test-classes=MyTest,OtherTest

  $ agentia cicd work submit --skip-local-tests

  $ agentia cicd work submit --skip-pull-request

  $ agentia cicd work submit --done

  $ agentia cicd work submit --deploy

  $ agentia cicd work submit --done --skip-nested-metadata-detection

  $ agentia cicd work submit --json
```

_See code: [src/commands/cicd/work/submit.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/submit.ts)_

## `agentia cicd work test`

Run quality gates for the current work item. With --local (the default) it runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present. When no project script exists it warns, runs the stock Agentia setup sample from a temporary file, then deletes that file. With --cloud it runs remote Copado quality gates (not implemented yet).

```
USAGE
  $ agentia cicd work test [--json] [--apex-test-classes <value>] [--cloud] [-e <value>...] [--local]
    [--rerun-failed-apex-tests]

FLAGS
  -e, --env=<value>...             Extra environment variable for the quality-gate script as NAME=value. Repeatable.
                                   Applied before reserved AGENTIA_APEX_* variables.
      --apex-test-classes=<value>  Comma-separated Apex test class names passed to local quality gates as
                                   AGENTIA_APEX_TEST_CLASSES
      --cloud                      Run remote Copado quality gates (not implemented yet).
      --local                      Run local project-root quality gates scripts. Used by default when --cloud is
                                   omitted.
      --rerun-failed-apex-tests    Pass AGENTIA_APEX_RERUN_FAILED=--rerun-failed-apex-tests to local quality gates so
                                   sample scripts forward that flag to work test apex.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Run quality gates for the current work item. With --local (the default) it runs project-root .agentia_quality_gates.sh
  (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present. When no project script exists it warns, runs the
  stock Agentia setup sample from a temporary file, then deletes that file. With --cloud it runs remote Copado quality
  gates (not implemented yet).

EXAMPLES
  $ agentia cicd work test

  $ agentia cicd work test --local --apex-test-classes=MyTest,OtherTest

  $ agentia cicd work test --local --rerun-failed-apex-tests

  $ agentia cicd work test -e SKIP_LWC_TESTS=1 -e TOOL_API_KEY=secret

  $ agentia cicd work test --json

  $ agentia cicd work test --cloud
```

_See code: [src/commands/cicd/work/test.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/test.ts)_

## `agentia cicd work test apex`

Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured. When `--apex-test-classes` is omitted or empty, logs that no Apex tests were specified and exits without running Salesforce CLI. Failed runs save `.agentia/apex.tests.<user-story>.json`; successful runs delete that file. `--rerun-failed-apex-tests` runs the previously failed classes (optionally filtered by `--apex-test-classes`). Prints the test-run summary when the run passes, or failing tests with their messages and stack traces when it fails. Exits with the same process exit code as Salesforce CLI (`sf`), including 100 when Apex tests fail.

```
USAGE
  $ agentia cicd work test apex [--json] [-t <value>] [--rerun-failed-apex-tests] [-w <value>]

FLAGS
  -t, --apex-test-classes=<value>  Comma-separated Apex test class names to run. Omit or leave empty to skip without
                                   running Salesforce CLI.
  -w, --wait=<value>               [default: 60] Minutes to wait for Salesforce CLI Apex test results
      --rerun-failed-apex-tests    Rerun Apex classes saved from the last failure for this user story
                                   (`.agentia/apex.tests.<user-story>.json`). Combined with --apex-test-classes, only
                                   matching failed classes run.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Usually run from
  project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are
  configured. When `--apex-test-classes` is omitted or empty, logs that no Apex tests were specified and exits without
  running Salesforce CLI. Failed runs save `.agentia/apex.tests.<user-story>.json`; successful runs delete that file.
  `--rerun-failed-apex-tests` runs the previously failed classes (optionally filtered by `--apex-test-classes`). Prints
  the test-run summary when the run passes, or failing tests with their messages and stack traces when it fails. Exits
  with the same process exit code as Salesforce CLI (`sf`), including 100 when Apex tests fail.

EXAMPLES
  $ agentia cicd work test apex -t HelloWorldTest

  $ agentia cicd work test apex --apex-test-classes=MyTest,OtherTest

  $ agentia cicd work test apex -t MyTest,OtherTest -w 10 --json

  $ agentia cicd work test apex -t "$AGENTIA_APEX_TEST_CLASSES"

  $ agentia cicd work test apex --rerun-failed-apex-tests
```

_See code: [src/commands/cicd/work/test/apex.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/test/apex.ts)_

## `agentia cicd work update [ID]`

Update a Copado user story by ID

```
USAGE
  $ agentia cicd work update [ID] [--json] [--excluded-from-cbm] [--custom-field <value>...] [--actual-points <value>]
    [--planned-points <value>] [--priority <value>] [--acceptance-criteria <value>] [--as-a <value>] [--assignee
    <value>] [--cancellation-reason <value>] [--close-date <value>] [--epic <value>] [--feature <value>]
    [--functional-requirements <value>] [--owner-id <value>] [--project <value>] [--record-type <value>] [--release-id
    <value>] [--so-that <value>] [--source-credential <value>] [--source-environment <value>] [--sprint-id <value>]
    [--status <value>] [--team <value>] [--technical-specifications <value>] [--theme <value>] [--title <value>]
    [--want-to <value>]

ARGUMENTS
  [ID]  User story ID (defaults to the active work item from `work set`)

FLAGS
  --acceptance-criteria=<value>       Acceptance criteria (maximum 255 characters)
  --actual-points=<value>             Actual points
  --as-a=<value>                      User story "as a" clause (maximum 255 characters)
  --assignee=<value>                  Assignee ID
  --cancellation-reason=<value>       Cancellation reason
  --close-date=<value>                Close date
  --custom-field=<value>...           Subscriber custom field as ApiName=value (string value). Repeat for multiple
                                      fields; duplicate apiNames are rejected.
  --epic=<value>                      Epic
  --[no-]excluded-from-cbm            Exclude from CBM
  --feature=<value>                   Feature
  --functional-requirements=<value>   Functional requirements (maximum 30000 characters)
  --owner-id=<value>                  Owner ID
  --planned-points=<value>            Planned points
  --priority=<value>                  Priority
  --project=<value>                   Project ID
  --record-type=<value>               Record type
  --release-id=<value>                Release ID
  --so-that=<value>                   User story "so that" clause (maximum 255 characters)
  --source-credential=<value>         Source credential ID. When set, sourceEnvironment is sent as null so Salesforce
                                      assigns the environment from the credential.
  --source-environment=<value>        Source environment ID. Ignored when --source-credential is also set.
  --sprint-id=<value>                 Sprint ID
  --status=<value>                    Status
  --team=<value>                      Team
  --technical-specifications=<value>  Technical specifications (maximum 30000 characters)
  --theme=<value>                     Theme
  --title=<value>                     Title (maximum 255 characters)
  --want-to=<value>                   User story "want to" clause (maximum 255 characters)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado user story by ID

EXAMPLES
  $ agentia cicd work update --title "Updated story"

  $ agentia cicd work update --custom-field JIRA_Key__c=CICD-1

  $ agentia cicd work update a0SKC000000CmZ2AU --title "Updated story"

  $ agentia cicd work update a0SKC000000CmZ2AU --status "In Progress" --json
```

_See code: [src/commands/cicd/work/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/cicd/work/update.ts)_

## `agentia help [COMMAND]`

Display help for agentia.

```
USAGE
  $ agentia help [COMMAND...] [-n]

ARGUMENTS
  [COMMAND...]  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for agentia.
```

_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.53/src/commands/help.ts)_

## `agentia mcp start`

Start the local Agentia MCP server over stdio

```
USAGE
  $ agentia mcp start

DESCRIPTION
  Start the local Agentia MCP server over stdio

EXAMPLES
  $ agentia mcp start

  $ agentia mcp start # long-running stdio MCP server for Cursor and other clients
```

_See code: [src/commands/mcp/start.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/mcp/start.ts)_

## `agentia plugins`

List installed plugins.

```
USAGE
  $ agentia plugins [--json] [--core]

FLAGS
  --core  Show core plugins.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List installed plugins.

EXAMPLES
  $ agentia plugins
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.84/src/commands/plugins/index.ts)_

## `agentia plugins add PLUGIN`

Install plugins with npm after checking them against the Agentia plugin catalog.

```
USAGE
  $ agentia plugins add PLUGIN... [--json] [--allow-unverified] [-f] [-s] [-v]

ARGUMENTS
  PLUGIN...  npm package name (optionally with @tag) or git URL.

FLAGS
  -f, --force             Force npm to fetch remote resources even if a local copy exists.
  -s, --silent            Silence npm output.
  -v, --verbose           Show verbose npm output.
      --allow-unverified  Install plugins that are not Official or Verified without asking. Never overrides a revoked or
                          mismatched version.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Install plugins with npm after checking them against the Agentia plugin catalog.

  Official and Verified plugins install without a prompt. Community, unlisted, and git URL plugins ask first. Use
  --allow-unverified when there is no terminal or with --json.

  A revoked version, or an npm tarball that differs from the hash in the catalog, is always refused. If the catalog
  cannot be reached, plugins cannot be checked, so the command warns and asks first, even for Official and Verified
  plugins. Use --allow-unverified to install without the check.

ALIASES
  $ agentia plugins add

EXAMPLES
  $ agentia plugins add @acme/agentia-plugin-x

  $ agentia plugins add @acme/agentia-plugin-x@1.2.0 --allow-unverified --json
```

## `agentia plugins:inspect PLUGIN...`

Displays installation properties of a plugin.

```
USAGE
  $ agentia plugins inspect PLUGIN...

ARGUMENTS
  PLUGIN...  [default: .] Plugin to inspect.

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Displays installation properties of a plugin.

EXAMPLES
  $ agentia plugins inspect myplugin
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.84/src/commands/plugins/inspect.ts)_

## `agentia plugins install PLUGIN`

Install plugins with npm after checking them against the Agentia plugin catalog.

```
USAGE
  $ agentia plugins install PLUGIN... [--json] [--allow-unverified] [-f] [-s] [-v]

ARGUMENTS
  PLUGIN...  npm package name (optionally with @tag) or git URL.

FLAGS
  -f, --force             Force npm to fetch remote resources even if a local copy exists.
  -s, --silent            Silence npm output.
  -v, --verbose           Show verbose npm output.
      --allow-unverified  Install plugins that are not Official or Verified without asking. Never overrides a revoked or
                          mismatched version.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Install plugins with npm after checking them against the Agentia plugin catalog.

  Official and Verified plugins install without a prompt. Community, unlisted, and git URL plugins ask first. Use
  --allow-unverified when there is no terminal or with --json.

  A revoked version, or an npm tarball that differs from the hash in the catalog, is always refused. If the catalog
  cannot be reached, plugins cannot be checked, so the command warns and asks first, even for Official and Verified
  plugins. Use --allow-unverified to install without the check.

ALIASES
  $ agentia plugins add

EXAMPLES
  $ agentia plugins install @acme/agentia-plugin-x

  $ agentia plugins install @acme/agentia-plugin-x@1.2.0 --allow-unverified --json
```

_See code: [src/commands/plugins/install.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/plugins/install.ts)_

## `agentia plugins link PATH`

Links a plugin into the CLI for development.

```
USAGE
  $ agentia plugins link PATH [-h] [--install] [-v]

ARGUMENTS
  PATH  [default: .] path to plugin

FLAGS
  -h, --help          Show CLI help.
  -v, --verbose
      --[no-]install  Install dependencies after linking the plugin.

DESCRIPTION
  Links a plugin into the CLI for development.

  Installation of a linked plugin will override a user-installed or core plugin.

  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
  command will override the user-installed or core plugin implementation. This is useful for development work.


EXAMPLES
  $ agentia plugins link myplugin
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.84/src/commands/plugins/link.ts)_

## `agentia plugins remove [PLUGIN]`

Removes a plugin from the CLI.

```
USAGE
  $ agentia plugins remove [PLUGIN...] [-h] [-v]

ARGUMENTS
  [PLUGIN...]  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ agentia plugins unlink
  $ agentia plugins remove

EXAMPLES
  $ agentia plugins remove myplugin
```

## `agentia plugins reset`

Remove all user-installed and linked plugins.

```
USAGE
  $ agentia plugins reset [--hard] [--reinstall]

FLAGS
  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
  --reinstall  Reinstall all plugins after uninstalling.
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.84/src/commands/plugins/reset.ts)_

## `agentia plugins uninstall [PLUGIN]`

Removes a plugin from the CLI.

```
USAGE
  $ agentia plugins uninstall [PLUGIN...] [-h] [-v]

ARGUMENTS
  [PLUGIN...]  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ agentia plugins unlink
  $ agentia plugins remove

EXAMPLES
  $ agentia plugins uninstall myplugin
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.84/src/commands/plugins/uninstall.ts)_

## `agentia plugins unlink [PLUGIN]`

Removes a plugin from the CLI.

```
USAGE
  $ agentia plugins unlink [PLUGIN...] [-h] [-v]

ARGUMENTS
  [PLUGIN...]  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ agentia plugins unlink
  $ agentia plugins remove

EXAMPLES
  $ agentia plugins unlink myplugin
```

## `agentia plugins update`

Update installed plugins.

```
USAGE
  $ agentia plugins update [-h] [-v]

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Update installed plugins.
```

_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.84/src/commands/plugins/update.ts)_

## `agentia setup`

Prepare this machine and the current project for Agentia. Guides CICD, AI, and CRT authentication, Cursor and Claude Code MCP, local quality gates, Agent Skills, agent rules, and removal of a legacy AGENTS.md section. Use --skip-auth to skip authentication and continue with Cursor and Claude Code MCP and project setup. Git is optional: .gitignore is updated only inside a repository, and generated files are not committed.

```
USAGE
  $ agentia setup [--skip-auth]

FLAGS
  --skip-auth  Skip CICD, AI, and CRT authentication; continue with Cursor and Claude Code MCP and project setup

DESCRIPTION
  Prepare this machine and the current project for Agentia. Guides CICD, AI, and CRT authentication, Cursor and Claude
  Code MCP, local quality gates, Agent Skills, agent rules, and removal of a legacy AGENTS.md section. Use --skip-auth
  to skip authentication and continue with Cursor and Claude Code MCP and project setup. Git is optional: .gitignore is
  updated only inside a repository, and generated files are not committed.

EXAMPLES
  $ agentia setup

  $ agentia setup --skip-auth
```

_See code: [src/commands/setup.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/setup.ts)_

## `agentia setup skills create`

Create portable Markdown-only Agentia CLI skills in this project without overwriting managed files

```
USAGE
  $ agentia setup skills create [--json] [--adv] [--ai] [--cicd] [--force] [-n] [--plugin <value>...] [--target
    agents|cursor|claude...] [--testing]

FLAGS
  -n, --no-prompt           Skip interactive prompts; defaults the target to .agents/skills when --target is omitted
      --adv                 Create the Copado Pipelines Advanced skill pack
      --ai                  Create the Copado AI agent skill pack
      --cicd                Create the Copado CICD skill pack
      --force               Replace conflicting unmanaged Agentia skill or rules files
      --plugin=<value>...   Also install the skills this installed plugin contributes through its agentia:contribute
                            hook (repeatable). Without pack flags only plugin skills are written
      --target=<option>...  Project skill root to write (repeatable)
                            <options: agents|cursor|claude>
      --testing             Create the Copado Robotic Testing skill pack

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create portable Markdown-only Agentia CLI skills in this project without overwriting managed files

EXAMPLES
  $ agentia setup skills create

  $ agentia setup skills create --adv --target agents --no-prompt

  $ agentia setup skills create --cicd --target agents --no-prompt

  $ agentia setup skills create --testing --ai --target cursor --no-prompt

  $ agentia setup skills create --json

  $ agentia setup skills create --plugin @acme/agentia-plugin-release --target cursor --no-prompt
```

_See code: [src/commands/setup/skills/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/setup/skills/create.ts)_

## `agentia setup skills list`

List skills that installed plugins contribute through their agentia:contribute hook (what "setup skills create|update --plugin" can install) and why invalid ones are skipped

```
USAGE
  $ agentia setup skills list [--json] [--plugin <value>...]

FLAGS
  --plugin=<value>...  Only list skills from this installed plugin (repeatable)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List skills that installed plugins contribute through their agentia:contribute hook (what "setup skills create|update
  --plugin" can install) and why invalid ones are skipped

EXAMPLES
  $ agentia setup skills list

  $ agentia setup skills list --plugin @acme/agentia-plugin-release --json
```

_See code: [src/commands/setup/skills/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/setup/skills/list.ts)_

## `agentia setup skills update`

Update Agentia-managed Markdown skill files and restore missing files in this project; without flags it also refreshes plugin skills already installed

```
USAGE
  $ agentia setup skills update [--json] [--adv] [--ai] [--cicd] [--force] [-n] [--prune | --plugin <value>...] [--target
    agents|cursor|claude...] [--testing]

FLAGS
  -n, --no-prompt           Skip interactive prompts; defaults the target to .agents/skills when --target is omitted
      --adv                 Update the Copado Pipelines Advanced skill pack
      --ai                  Update the Copado AI agent skill pack
      --cicd                Update the Copado CICD skill pack
      --force               Replace conflicting unmanaged Agentia skill or rules files
      --plugin=<value>...   Also install the skills this installed plugin contributes through its agentia:contribute
                            hook (repeatable). Without pack flags only plugin skills are written
      --prune               Also delete installed plugin skills whose plugin is uninstalled or no longer contributes
                            them (only files carrying that plugin's managed marker)
      --target=<option>...  Project skill root to write (repeatable)
                            <options: agents|cursor|claude>
      --testing             Update the Copado Robotic Testing skill pack

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update Agentia-managed Markdown skill files and restore missing files in this project; without flags it also refreshes
  plugin skills already installed

EXAMPLES
  $ agentia setup skills update

  $ agentia setup skills update --ai --target cursor --no-prompt

  $ agentia setup skills update --adv --target agents --no-prompt

  $ agentia setup skills update --cicd --testing --target agents --no-prompt

  $ agentia setup skills update --force --json

  $ agentia setup skills update --prune --target cursor --no-prompt

  $ agentia setup skills update --plugin @acme/agentia-plugin-release --target cursor --no-prompt
```

_See code: [src/commands/setup/skills/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/setup/skills/update.ts)_

## `agentia testing data-table create`

Create a Copado Robotic Testing data table

```
USAGE
  $ agentia testing data-table create -p <value> --name <value> [--json] [--job <value>] [--file <value>] [--header row|column]
    [--json-data <value>] [--stdin] [--ai-generated] [--default-row <value>] [--topics <value>] [-y]

FLAGS
  -p, --project=<value>      (required) CRT project ID.
  -y, --yes                  Confirm creation after reviewing or bypassing preview.
      --ai-generated         Mark the table as AI-generated.
      --default-row=<value>  Default dataset row (1-based).
      --file=<value>         Read data from a CSV, TSV, JSON, or XLSX file.
      --header=<option>      [default: row] Location of variable headers in imported data.
                             <options: row|column>
      --job=<value>          Optional CRT job ID filter.
      --json-data=<value>    Inline JSON array of row arrays. Mutually exclusive with --file/--stdin.
      --name=<value>         (required) Data-table name.
      --stdin                Read CSV, TSV, or JSON data from stdin.
      --topics=<value>       Comma-separated topic tags.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado Robotic Testing data table

EXAMPLES
  $ agentia testing data-table create --project <project-id> --name Customers --file customers.csv --yes

  $ agentia testing data-table create --project <project-id> --name Customers --json-data '[["name"],["Alice"]]' --yes --json
```

_See code: [src/commands/testing/data-table/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/data-table/create.ts)_

## `agentia testing data-table delete ID`

Delete a Copado Robotic Testing data table

```
USAGE
  $ agentia testing data-table delete ID -p <value> [--json] [--job <value>] [-y]

ARGUMENTS
  ID  CRT data-table ID.

FLAGS
  -p, --project=<value>  (required) CRT project ID.
  -y, --yes              Confirm data-table deletion.
      --job=<value>      Optional CRT job ID filter.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado Robotic Testing data table

EXAMPLES
  $ agentia testing data-table delete <table-id> --project <project-id> --yes

  $ agentia testing data-table delete <table-id> --project <project-id> --yes --json
```

_See code: [src/commands/testing/data-table/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/data-table/delete.ts)_

## `agentia testing data-table export ID`

Export a Copado Robotic Testing data table

```
USAGE
  $ agentia testing data-table export ID -p <value> -o <value> [--json] [--job <value>] [-r <value>] [--datasets <value>]
    [--format csv|tsv|xlsx] [-y]

ARGUMENTS
  ID  CRT data-table ID.

FLAGS
  -o, --output=<value>    (required) Explicit local output file.
  -p, --project=<value>   (required) CRT project ID.
  -r, --revision=<value>  Specific data-table revision/version.
  -y, --yes               Confirm overwriting an existing output file.
      --datasets=<value>  1-based dataset list/ranges to export.
      --format=<option>   Output format; defaults to the output extension.
                          <options: csv|tsv|xlsx>
      --job=<value>       Optional CRT job ID filter.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Export a Copado Robotic Testing data table

EXAMPLES
  $ agentia testing data-table export <table-id> --project <project-id> --output table.csv

  $ agentia testing data-table export <table-id> --project <project-id> --datasets 1-3 --output table.xlsx --yes --json
```

_See code: [src/commands/testing/data-table/export.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/data-table/export.ts)_

## `agentia testing data-table get ID`

Get a Copado Robotic Testing data table

```
USAGE
  $ agentia testing data-table get ID -p <value> [--json] [--job <value>] [-r <value>] [--datasets <value>]

ARGUMENTS
  ID  CRT data-table ID.

FLAGS
  -p, --project=<value>   (required) CRT project ID.
  -r, --revision=<value>  Specific data-table revision/version.
      --datasets=<value>  1-based dataset list/ranges to return, for example 1,3-5.
      --job=<value>       Optional CRT job ID filter.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado Robotic Testing data table

EXAMPLES
  $ agentia testing data-table get <table-id> --project <project-id>

  $ agentia testing data-table get <table-id> --project <project-id> --datasets 1,3-5 --json
```

_See code: [src/commands/testing/data-table/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/data-table/get.ts)_

## `agentia testing data-table list`

List Copado Robotic Testing data tables

```
USAGE
  $ agentia testing data-table list -p <value> [--json] [--job <value>] [-r <value>] [--fields <value>] [--name <value>]

FLAGS
  -p, --project=<value>   (required) CRT project ID.
  -r, --revision=<value>  Specific data-table revision/version.
      --fields=<value>    Comma-separated server fields to return.
      --job=<value>       Optional CRT job ID filter.
      --name=<value>      Exact data-table name filter.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado Robotic Testing data tables

EXAMPLES
  $ agentia testing data-table list --project <project-id>

  $ agentia testing data-table list --project <project-id> --job <job-id> --name Customers --json
```

_See code: [src/commands/testing/data-table/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/data-table/list.ts)_

## `agentia testing data-table update ID`

Update a Copado Robotic Testing data table

```
USAGE
  $ agentia testing data-table update ID -p <value> [--json] [--job <value>] [--file <value>] [--header row|column]
    [--json-data <value>] [--stdin] [--ai-generated true|false] [--default-row <value>] [--topics <value>] [-y]

ARGUMENTS
  ID  CRT data-table ID.

FLAGS
  -p, --project=<value>        (required) CRT project ID.
  -y, --yes                    Confirm update after reviewing or bypassing preview.
      --ai-generated=<option>  Set whether the table is AI-generated.
                               <options: true|false>
      --default-row=<value>    Default dataset row (1-based).
      --file=<value>           Read data from a CSV, TSV, JSON, or XLSX file.
      --header=<option>        [default: row] Location of variable headers in imported data.
                               <options: row|column>
      --job=<value>            Optional CRT job ID filter.
      --json-data=<value>      Inline JSON array of row arrays. Mutually exclusive with --file/--stdin.
      --stdin                  Read CSV, TSV, or JSON data from stdin.
      --topics=<value>         Replacement comma-separated topics; pass an empty value to clear.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado Robotic Testing data table

EXAMPLES
  $ agentia testing data-table update <table-id> --project <project-id> --file customers.csv --yes

  $ agentia testing data-table update <table-id> --project <project-id> --topics smoke,regression --yes --json
```

_See code: [src/commands/testing/data-table/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/data-table/update.ts)_

## `agentia testing job create`

Create a Copado Robotic Testing job from uploaded files or Git storage

```
USAGE
  $ agentia testing job create -p <value> --name <value> --robot <value> [--json] [--dir <value>...] [-f <value>...]
    [--git-branch <value>] [--git-domain-credential <value>] [--git-password <value> | --git-password-file <value> |
    --git-password-stdin] [--git-tag <value>] [--git-url <value>] [--git-use-caller-credentials] [--git-username
    <value>] [--author-email <value>] [--author-name <value>] [--base-path <value>] [--case-duration-change-detection]
    [--description <value>] [--dry-run] [--message <value>] [--parallel-mode disabled|enabled] [--parent-commit <value>]
    [--remote-prefix <value>] [--screen-depth <value>] [--screen-height <value>] [--screen-width <value>]
    [--show-video-params] [--suite-type bitbar|browserstack|browserstackdesktop|default|lambdatest|lambdatestdesktop|mob
    ile|paceconnectmobile|privatemobile|rpa|selenese|zap] [--timeout <value>] [--validation]

FLAGS
  -f, --file=<value>...                      Robot Framework file to upload. Can be provided multiple times.
  -p, --project=<value>                      (required) CRT project ID.
      --author-email=<value>                 [default: agentia@copado.com] Author email for initial file history.
      --author-name=<value>                  [default: Agentia CLI] Author name for initial file history.
      --base-path=<value>                    Require local files to stay within this directory.
      --[no-]case-duration-change-detection  Enable or disable duration analytics.
      --description=<value>                  Job description.
      --dir=<value>...                       Directory containing Robot Framework files to upload. Can be provided
                                             multiple times.
      --dry-run                              Return a sanitized creation plan without network mutation.
      --git-branch=<value>                   Git branch to use for a Git-backed CRT job. Mutually exclusive with
                                             --git-tag.
      --git-domain-credential=<value>        CRT domain credential ID to use for Git repository access.
      --git-password=<value>                 Git password/token for repository access. Prefer --git-domain-credential
                                             when available.
      --git-password-file=<value>            Read a bounded Git password/token from a regular file.
      --git-password-stdin                   Read a Git password/token from stdin.
      --git-tag=<value>                      Git tag to use for a Git-backed CRT job. Mutually exclusive with
                                             --git-branch.
      --git-url=<value>                      Git repository URL for a Git-backed CRT job.
      --git-use-caller-credentials           Use caller credentials for Git repository access instead of explicit Git
                                             username/password.
      --git-username=<value>                 Git username for repository access. Prefer --git-domain-credential when
                                             available.
      --message=<value>                      Commit message for initial file upload.
      --name=<value>                         (required) Job name.
      --parallel-mode=<option>               Parallel execution mode.
                                             <options: disabled|enabled>
      --parent-commit=<value>                Expected parent commit hash for initial upload.
      --remote-prefix=<value>                Validated remote prefix for initial local files.
      --robot=<value>                        (required) CRT robot ID.
      --screen-depth=<value>                 Screen color depth.
      --screen-height=<value>                Screen height.
      --screen-width=<value>                 Screen width.
      --[no-]show-video-params               Enable or disable video streaming and recording capabilities when running
                                             the test job.
      --suite-type=<option>                  CRT suite/job type.
                                             <options: bitbar|browserstack|browserstackdesktop|default|lambdatest|lambda
                                             testdesktop|mobile|paceconnectmobile|privatemobile|rpa|selenese|zap>
      --timeout=<value>                      Build timeout, for example 10m.
      --validation                           Ask CRT to validate the created job.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado Robotic Testing job from uploaded files or Git storage

EXAMPLES
  $ agentia testing job create --project <project-id> --robot <robot-id> --name "Smoke" --file tests.robot

  $ agentia testing job create --project <project-id> --robot <robot-id> --name "Smoke" --dir tests --json

  $ agentia testing job create --project <project-id> --robot <robot-id> --name "Smoke" --git-url https://github.com/acme/crt-tests.git --git-branch main
```

_See code: [src/commands/testing/job/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/create.ts)_

## `agentia testing job delete ID`

Delete a Copado Robotic Testing job

```
USAGE
  $ agentia testing job delete ID -p <value> [--json] [-y]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -p, --project=<value>  (required) CRT project ID.
  -y, --yes              Skip the destructive confirmation prompt.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado Robotic Testing job

EXAMPLES
  $ agentia testing job delete <job-id> --project <project-id> --yes

  $ agentia testing job delete <job-id> --project <project-id> --yes --json
```

_See code: [src/commands/testing/job/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/delete.ts)_

## `agentia testing job files download ID`

Download files from a Copado Robotic Testing job

```
USAGE
  $ agentia testing job files download ID -p <value> -f <value>... [--json] [--branch <value>] [-o <value>]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -f, --file=<value>...     (required) Remote CRT file path to download. Can be provided multiple times.
  -o, --output-dir=<value>  Directory to write downloaded files.
  -p, --project=<value>     (required) CRT project ID.
      --branch=<value>      Optional CRT branch name for file operations.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Download files from a Copado Robotic Testing job

EXAMPLES
  $ agentia testing job files download <job-id> --project <project-id> --file tests.robot

  $ agentia testing job files download <job-id> --project <project-id> --file tests.robot --output-dir ./crt-files --json
```

_See code: [src/commands/testing/job/files/download.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/files/download.ts)_

## `agentia testing job files list ID`

List files for a Copado Robotic Testing job

```
USAGE
  $ agentia testing job files list ID -p <value> [--json] [--branch <value>] [--shared-credentials]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -p, --project=<value>          (required) CRT project ID.
      --branch=<value>           Optional CRT branch name for file operations.
      --[no-]shared-credentials  Use shared stored Git credentials.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List files for a Copado Robotic Testing job

EXAMPLES
  $ agentia testing job files list <job-id> --project <project-id>

  $ agentia testing job files list <job-id> --project <project-id> --branch main --json
```

_See code: [src/commands/testing/job/files/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/files/list.ts)_

## `agentia testing job files upload ID`

Upload file operations to a Copado Robotic Testing job

```
USAGE
  $ agentia testing job files upload ID -p <value> [--json] [--branch <value>] [--add <value>...] [--remove <value>...]
    [--replace <value>...] [--author-email <value>] [--author-name <value>] [--base-path <value>] [--dry-run] [--message
    <value>] [--parent-commit <value>] [--remote-prefix <value>]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -p, --project=<value>        (required) CRT project ID.
      --add=<value>...         Add a file using local[:remote] syntax. Can be provided multiple times.
      --author-email=<value>   [default: agentia@copado.com] Author email for CRT file history.
      --author-name=<value>    [default: Agentia CLI] Author name for CRT file history.
      --base-path=<value>      Require local upload files to stay within this directory and derive relative paths from
                               it.
      --branch=<value>         Optional CRT branch name for file operations.
      --dry-run                Return a sanitized upload plan without making a network mutation.
      --message=<value>        Commit message for CRT file history.
      --parent-commit=<value>  Expected parent commit hash.
      --remote-prefix=<value>  Validated remote path prefix for all operations.
      --remove=<value>...      Remove a remote CRT file path. Can be provided multiple times.
      --replace=<value>...     Replace a file using local[:remote] syntax. Can be provided multiple times.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Upload file operations to a Copado Robotic Testing job

EXAMPLES
  $ agentia testing job files upload <job-id> --project <project-id> --add tests.robot

  $ agentia testing job files upload <job-id> --project <project-id> --replace local.robot:tests.robot --remove old.robot --json

  $ agentia testing job files upload <job-id> --project <project-id> --add tests/smoke.robot --base-path tests --remote-prefix suites --dry-run --json
```

_See code: [src/commands/testing/job/files/upload.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/files/upload.ts)_

## `agentia testing job get ID`

Get a Copado Robotic Testing job from the project job list

```
USAGE
  $ agentia testing job get ID -p <value> [--json]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -p, --project=<value>  (required) CRT project ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado Robotic Testing job from the project job list

EXAMPLES
  $ agentia testing job get <job-id> --project <project-id>

  $ agentia testing job get <job-id> --project <project-id> --json
```

_See code: [src/commands/testing/job/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/get.ts)_

## `agentia testing job list`

List Copado Robotic Testing jobs in a project

```
USAGE
  $ agentia testing job list -p <value> [--json] [--name <value>]

FLAGS
  -p, --project=<value>  (required) CRT project ID.
      --name=<value>     Case-insensitive exact job name to match client-side.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado Robotic Testing jobs in a project

EXAMPLES
  $ agentia testing job list --project <project-id>

  $ agentia testing job list --project <project-id> --name "Smoke" --json
```

_See code: [src/commands/testing/job/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/list.ts)_

## `agentia testing job refs ID`

List Git branches and tags for a Copado Robotic Testing job

```
USAGE
  $ agentia testing job refs ID -p <value> [--json] [--shared-credentials]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -p, --project=<value>          (required) CRT project ID.
      --[no-]shared-credentials  Use shared stored Git credentials.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Git branches and tags for a Copado Robotic Testing job

EXAMPLES
  $ agentia testing job refs <job-id> --project <project-id>

  $ agentia testing job refs <job-id> --project <project-id> --shared-credentials --json
```

_See code: [src/commands/testing/job/refs.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/refs.ts)_

## `agentia testing job run ID`

Run a Copado Robotic Testing job

```
USAGE
  $ agentia testing job run ID -p <value> [--json] [--branch <value>] [--console-colors auto|on|ansi|off]
    [--console-width <value>] [--datatable <value>...] [--doc <value>] [--dry-run] [--exclude <value>...]
    [--exit-on-error] [--exit-on-failure] [--include <value>...] [--metadata <value>...] [--name <value>]
    [--no-exit-code] [--param <value>...] [--record all|failed|none] [--rerun-failed <value>]
    [--rerun-failed-from-latest] [--run-empty-suite] [--run-type regression|development] [--save-artifacts <value>]
    [--set-tag <value>...] [--skip <value>...] [--skip-on-failure <value>...] [--stream-logs] [--suite <value>...]
    [--tag <value>] [--test <value>...] [--timeout <value>] [--variable <value>...] [--wait] [--xunit <value>]

ARGUMENTS
  ID  CRT job ID to run.

FLAGS
  -p, --project=<value>             (required) CRT project ID.
      --branch=<value>              Git branch/ref to use for this run. Mutually exclusive with --tag.
      --console-colors=<option>     Control Robot Framework console colors.
                                    <options: auto|on|ansi|off>
      --console-width=<value>       Set Robot Framework console width.
      --datatable=<value>...        Data table and 1-based datasets as TABLE_ID:1,2-4. Repeat for zipped table
                                    selections.
      --doc=<value>                 Set top-level Robot Framework suite documentation.
      --dry-run                     Validate Robot Framework data without executing library keywords.
      --exclude=<value>...          Robot Framework tag to exclude from this run. Can be provided multiple times.
      --exit-on-error               Stop execution when Robot Framework encounters a data or import error.
      --exit-on-failure             Stop execution when a critical Robot Framework test fails.
      --include=<value>...          Robot Framework tag to include in this run. Can be provided multiple times.
      --metadata=<value>...         Robot Framework suite metadata. Can be provided multiple times.
      --name=<value>                Set the top-level Robot Framework suite name.
      --no-exit-code                Return exit code zero even when the CRT run fails.
      --param=<value>...            Execution parameter in KEY=VALUE format. Can be provided multiple times.
      --record=<option>             CRT execution recording mode.
                                    <options: all|failed|none>
      --rerun-failed=<value>        Rerun failed tests from the specified build/run ID. Mutually exclusive with
                                    --rerun-failed-from-latest.
      --rerun-failed-from-latest    Rerun failed tests from the latest failed run. Mutually exclusive with
                                    --rerun-failed.
      --run-empty-suite             Execute even when the selected Robot Framework suite is empty.
      --run-type=<option>           CRT run type. Regression is sent as normal; development is sent unchanged.
                                    <options: regression|development>
      --save-artifacts=<value>      Save the completed run output ZIP to this explicit file path.
      --set-tag=<value>...          Set a tag on all executed tests. Can be provided multiple times.
      --skip=<value>...             Skip tests matching this tag. Can be provided multiple times.
      --skip-on-failure=<value>...  Skip failures for tests matching this tag. Can be provided multiple times.
      --[no-]stream-logs            Print CRT run log output as the run executes (default, human output only). Use
                                    --no-stream-logs for a progress spinner instead.
      --suite=<value>...            Select a Robot Framework suite. Can be provided multiple times.
      --tag=<value>                 Git tag to use for this run. Mutually exclusive with --branch.
      --test=<value>...             Select a Robot Framework test/task. Can be provided multiple times.
      --timeout=<value>             [default: 60] Maximum number of minutes to wait for a terminal result.
      --variable=<value>...         Set a Robot Framework variable. Can be provided multiple times.
      --[no-]wait                   Poll CRT until the started build reaches a terminal result (default). Use --no-wait
                                    to return once the run has been queued.
      --xunit=<value>               Extract xunit_report.xml from completed run artifacts to this explicit file path.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Run a Copado Robotic Testing job

EXAMPLES
  $ agentia testing job run <job-id> --project <project-id>

  $ agentia testing job run <job-id> --project <project-id> --param BROWSER=chrome --record failed

  $ agentia testing job run <job-id> --project <project-id> --no-wait --json
```

_See code: [src/commands/testing/job/run.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/run.ts)_

## `agentia testing job runs abort ID`

Abort a Copado Robotic Testing job run

```
USAGE
  $ agentia testing job runs abort ID -p <value> -j <value> [--json] [-y]

ARGUMENTS
  ID  CRT build/run ID.

FLAGS
  -j, --job=<value>      (required) CRT job ID.
  -p, --project=<value>  (required) CRT project ID.
  -y, --yes              Skip the destructive confirmation prompt.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Abort a Copado Robotic Testing job run

EXAMPLES
  $ agentia testing job runs abort <build-id> --project <project-id> --job <job-id> --yes

  $ agentia testing job runs abort <build-id> --project <project-id> --job <job-id> --yes --json
```

_See code: [src/commands/testing/job/runs/abort.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/runs/abort.ts)_

## `agentia testing job runs get ID`

Get the result of a Copado Robotic Testing job run

```
USAGE
  $ agentia testing job runs get ID -p <value> -j <value> [--json] [--full]

ARGUMENTS
  ID  CRT build/run ID.

FLAGS
  -j, --job=<value>      (required) CRT job ID.
  -p, --project=<value>  (required) CRT project ID.
      --full             Fetch the full build result instead of the compact summary.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get the result of a Copado Robotic Testing job run

EXAMPLES
  $ agentia testing job runs get <build-id> --project <project-id> --job <job-id>

  $ agentia testing job runs get <build-id> --project <project-id> --job <job-id> --full --json
```

_See code: [src/commands/testing/job/runs/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/runs/get.ts)_

## `agentia testing job runs list`

List Copado Robotic Testing job runs

```
USAGE
  $ agentia testing job runs list -p <value> [--json] [--count] [--job <value>] [--page <value>] [--page-size <value>]
    [--result-size compact] [--status aborted|executing|failed|finished|queued|succeeded]

FLAGS
  -p, --project=<value>       (required) CRT project ID.
      --count                 Return only the number of builds. Requires --job.
      --job=<value>           Limit builds to one CRT job ID.
      --page=<value>          CRT build page number.
      --page-size=<value>     Number of CRT builds per page.
      --result-size=<option>  [default: compact] CRT build result size.
                              <options: compact>
      --status=<option>       Build status filter.
                              <options: aborted|executing|failed|finished|queued|succeeded>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado Robotic Testing job runs

EXAMPLES
  $ agentia testing job runs list --project <project-id>

  $ agentia testing job runs list --project <project-id> --status failed --json

  $ agentia testing job runs list --project <project-id> --job <job-id> --status succeeded --json

  $ agentia testing job runs list --project <project-id> --job <job-id> --count
```

_See code: [src/commands/testing/job/runs/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/runs/list.ts)_

## `agentia testing job runs logs ID`

Get logs for a Copado Robotic Testing job run

```
USAGE
  $ agentia testing job runs logs ID -p <value> -j <value> [--json] [--container <value>] [--limit-bytes <value>]
    [--pretty] [--since-seconds <value>] [--tail-lines <value>] [--timestamps] [-o <value>]

ARGUMENTS
  ID  CRT build/run ID.

FLAGS
  -j, --job=<value>            (required) CRT job ID.
  -o, --output=<value>         Write raw output to this file path.
  -p, --project=<value>        (required) CRT project ID.
      --container=<value>      Read a specific CRT log stream/container.
      --limit-bytes=<value>    Limit fetched log data to this many bytes.
      --pretty                 Request readable log formatting.
      --since-seconds=<value>  Fetch log lines from the last N seconds.
      --tail-lines=<value>     Return only the last N log lines.
      --timestamps             Add timestamps to log lines.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get logs for a Copado Robotic Testing job run

EXAMPLES
  $ agentia testing job runs logs <build-id> --project <project-id> --job <job-id>

  $ agentia testing job runs logs <build-id> --project <project-id> --job <job-id> --tail-lines 200

  $ agentia testing job runs logs <build-id> --project <project-id> --job <job-id> --output log.html --json
```

_See code: [src/commands/testing/job/runs/logs.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/runs/logs.ts)_

## `agentia testing job runs search`

Search Copado Robotic Testing job run metrics

```
USAGE
  $ agentia testing job runs search -p <value> -j <value> [--json] [--count] [--from <value>] [--order asc|desc] [--page
    <value>] [--page-size <value>] [--robot <value>...] [--run-type regression|development...] [--sort
    date|duration|id|status] [--status <value>...] [--to <value>]

FLAGS
  -j, --job=<value>           (required) CRT job ID.
  -p, --project=<value>       (required) CRT project ID.
      --count                 Return only the filtered build count.
      --from=<value>          Include builds at or after this ISO-8601 date or epoch value.
      --order=<option>        [default: desc]
                              <options: asc|desc>
      --page=<value>          [default: 1]
      --page-size=<value>     [default: 50]
      --robot=<value>...      Robot ID filter. Can be provided multiple times.
      --run-type=<option>...  Run type filter. Can be provided multiple times.
                              <options: regression|development>
      --sort=<option>         [default: date]
                              <options: date|duration|id|status>
      --status=<value>...     Status filter. Can be provided multiple times.
      --to=<value>            Include builds at or before this ISO-8601 date or epoch value.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Search Copado Robotic Testing job run metrics

EXAMPLES
  $ agentia testing job runs search --project <project-id> --job <job-id> --status failed

  $ agentia testing job runs search --project <project-id> --job <job-id> --run-type regression --count --json
```

_See code: [src/commands/testing/job/runs/search.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/runs/search.ts)_

## `agentia testing job schedule get ID`

Get the schedule for a Copado Robotic Testing job

```
USAGE
  $ agentia testing job schedule get ID -p <value> [--json]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -p, --project=<value>  (required) CRT project ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get the schedule for a Copado Robotic Testing job

EXAMPLES
  $ agentia testing job schedule get <job-id> --project <project-id>

  $ agentia testing job schedule get <job-id> --project <project-id> --json
```

_See code: [src/commands/testing/job/schedule/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/schedule/get.ts)_

## `agentia testing job schedule remove ID`

Remove the schedule from a Copado Robotic Testing job

```
USAGE
  $ agentia testing job schedule remove ID -p <value> [--json] [-y]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -p, --project=<value>  (required) CRT project ID.
  -y, --yes              Confirm schedule removal.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Remove the schedule from a Copado Robotic Testing job

EXAMPLES
  $ agentia testing job schedule remove <job-id> --project <project-id> --yes

  $ agentia testing job schedule remove <job-id> --project <project-id> --yes --json
```

_See code: [src/commands/testing/job/schedule/remove.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/schedule/remove.ts)_

## `agentia testing job schedule set ID`

Create or update a Copado Robotic Testing job schedule

```
USAGE
  $ agentia testing job schedule set ID -p <value> --cron <value> [--json] [--record all|failed|none] [--timezone
  <value>]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -p, --project=<value>   (required) CRT project ID.
      --cron=<value>      (required) Cron expression for the schedule.
      --record=<option>   Recording mode for scheduled runs.
                          <options: all|failed|none>
      --timezone=<value>  Timezone for the schedule, for example Europe/Helsinki.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create or update a Copado Robotic Testing job schedule

EXAMPLES
  $ agentia testing job schedule set <job-id> --project <project-id> --cron "0 6 * * 1-5"

  $ agentia testing job schedule set <job-id> --project <project-id> --cron "0 6 * * *" --timezone Europe/Helsinki --record failed --json
```

_See code: [src/commands/testing/job/schedule/set.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/schedule/set.ts)_

## `agentia testing job update ID`

Update Copado Robotic Testing job metadata

```
USAGE
  $ agentia testing job update ID -p <value> [--json] [--git-branch <value>] [--git-domain-credential <value>]
    [--git-password <value> | --git-password-file <value> | --git-password-stdin] [--git-tag <value>] [--git-url
    <value>] [--git-use-caller-credentials] [--git-username <value>] [--case-duration-change-detection] [--description
    <value>] [--name <value>] [--parallel-mode disabled|enabled] [--robot <value>] [--screen-depth <value>]
    [--screen-height <value>] [--screen-width <value>] [--show-video-params] [--suite-type bitbar|browserstack|browserst
    ackdesktop|default|lambdatest|lambdatestdesktop|mobile|paceconnectmobile|privatemobile|rpa|selenese|zap] [--timeout
    <value>]

ARGUMENTS
  ID  CRT job ID.

FLAGS
  -p, --project=<value>                      (required) CRT project ID.
      --[no-]case-duration-change-detection  Enable or disable duration analytics.
      --description=<value>                  Job description.
      --git-branch=<value>                   Git branch to use for a Git-backed CRT job. Mutually exclusive with
                                             --git-tag.
      --git-domain-credential=<value>        CRT domain credential ID to use for Git repository access.
      --git-password=<value>                 Git password/token for repository access. Prefer --git-domain-credential
                                             when available.
      --git-password-file=<value>            Read a bounded Git password/token from a regular file.
      --git-password-stdin                   Read a Git password/token from stdin.
      --git-tag=<value>                      Git tag to use for a Git-backed CRT job. Mutually exclusive with
                                             --git-branch.
      --git-url=<value>                      Git repository URL for a Git-backed CRT job.
      --git-use-caller-credentials           Use caller credentials for Git repository access instead of explicit Git
                                             username/password.
      --git-username=<value>                 Git username for repository access. Prefer --git-domain-credential when
                                             available.
      --name=<value>                         Job name.
      --parallel-mode=<option>               Parallel execution mode.
                                             <options: disabled|enabled>
      --robot=<value>                        CRT robot ID that should execute this job.
      --screen-depth=<value>                 Screen color depth. Must be provided with --screen-width and
                                             --screen-height.
      --screen-height=<value>                Screen height. Must be provided with --screen-width and --screen-depth.
      --screen-width=<value>                 Screen width. Must be provided with --screen-height and --screen-depth.
      --[no-]show-video-params               Enable or disable video streaming and recording capabilities when running
                                             the test job.
      --suite-type=<option>                  CRT suite/job type.
                                             <options: bitbar|browserstack|browserstackdesktop|default|lambdatest|lambda
                                             testdesktop|mobile|paceconnectmobile|privatemobile|rpa|selenese|zap>
      --timeout=<value>                      Build timeout, for example 10s, 10m, 10h, or 10d.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update Copado Robotic Testing job metadata

EXAMPLES
  $ agentia testing job update <job-id> --project <project-id> --name "Smoke"

  $ agentia testing job update <job-id> --project <project-id> --git-url https://github.com/acme/crt-tests.git --git-branch main

  $ agentia testing job update <job-id> --project <project-id> --git-branch feature/login-smoke

  $ agentia testing job update <job-id> --project <project-id> --timeout 10m --parallel-mode enabled --json
```

_See code: [src/commands/testing/job/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/job/update.ts)_

## `agentia testing live continue [JOB-ID]`

Continue paused Robot execution in the active CRT live session

```
USAGE
  $ agentia testing live continue [JOB-ID] -p <value> [--json] [--session-id <value>]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -p, --project=<value>     (required) CRT project ID.
      --session-id=<value>  Guard that must match the locally active CRT live session.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Continue paused Robot execution in the active CRT live session

EXAMPLES
  $ agentia testing live continue --project <project-id>
```

_See code: [src/commands/testing/live/continue.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/continue.ts)_

## `agentia testing live execute [JOB-ID]`

Execute bounded Robot Framework keywords in an active CRT live session

```
USAGE
  $ agentia testing live execute [JOB-ID] -p <value> [--json] [--session-id <value>] [--arg <value>...] [--file <value>]
    [--keyword <value>] [--line <value>...] [--raw] [--section <value>] [--section-index <value>]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -p, --project=<value>        (required) CRT project ID.
      --arg=<value>...         Keyword argument. Repeat to preserve argument boundaries.
      --file=<value>           Robot Framework input file.
      --keyword=<value>        Robot Framework keyword name.
      --line=<value>...        Raw Robot Framework keyword line. Repeat for multiple lines.
      --raw                    Treat file input as raw keyword lines.
      --section=<value>        Robot test/task name to execute.
      --section-index=<value>  One-based Robot test/task index to execute.
      --session-id=<value>     Guard that must match the locally active CRT live session.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Execute bounded Robot Framework keywords in an active CRT live session

EXAMPLES
  $ agentia testing live execute --project <project-id> --keyword GoTo --arg https://example.com

  $ agentia testing live execute <job-id> --project <project-id> --file smoke.robot --section Login
```

_See code: [src/commands/testing/live/execute.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/execute.ts)_

## `agentia testing live history [JOB-ID]`

Read bounded sanitized local CRT live execution history

```
USAGE
  $ agentia testing live history [JOB-ID] -p <value> [--json] [--session-id <value>] [--limit <value>] [--status
    completed|failed|recorded]

ARGUMENTS
  [JOB-ID]  CRT job ID; defaults to the active session.

FLAGS
  -p, --project=<value>     (required) CRT project ID.
      --limit=<value>       [default: 10] Maximum records to return.
      --session-id=<value>  Guard that must match the locally active CRT live session.
      --status=<option>     Execution status filter.
                            <options: completed|failed|recorded>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Read bounded sanitized local CRT live execution history

EXAMPLES
  $ agentia testing live history <job-id> --project <project-id> --limit 20 --json
```

_See code: [src/commands/testing/live/history.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/history.ts)_

## `agentia testing live inspect [JOB-ID]`

Inspect bounded, sanitized page state from an active CRT live session

```
USAGE
  $ agentia testing live inspect [JOB-ID] -p <value> [--json] [--session-id <value>] [--output <value> --dom]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -p, --project=<value>     (required) CRT project ID.
      --dom                 Fetch raw page DOM; requires --output.
      --output=<value>      Explicit file path for raw DOM.
      --session-id=<value>  Guard that must match the locally active CRT live session.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Inspect bounded, sanitized page state from an active CRT live session

EXAMPLES
  $ agentia testing live inspect --project <project-id> --json

  $ agentia testing live inspect --project <project-id> --dom --output page.html
```

_See code: [src/commands/testing/live/inspect.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/inspect.ts)_

## `agentia testing live interrupt [JOB-ID]`

Interrupt Robot execution in the active CRT live session

```
USAGE
  $ agentia testing live interrupt [JOB-ID] -p <value> [--json] [--session-id <value>]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -p, --project=<value>     (required) CRT project ID.
      --session-id=<value>  Guard that must match the locally active CRT live session.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Interrupt Robot execution in the active CRT live session

EXAMPLES
  $ agentia testing live interrupt --project <project-id>
```

_See code: [src/commands/testing/live/interrupt.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/interrupt.ts)_

## `agentia testing live recorder [JOB-ID]`

Record CRT live interactions as bounded Robot Framework lines

```
USAGE
  $ agentia testing live recorder [JOB-ID] -p <value> [--session-id <value>] [--debug] [--no-enable] [-o <value>]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -o, --output=<value>      Explicit .robot file to append recorded keywords to.
  -p, --project=<value>     (required) CRT project ID.
      --debug               Print frame sizes and event types without frame bodies.
      --no-enable           Do not manage the server recorder toggle.
      --session-id=<value>  Guard that must match the locally active CRT live session.

DESCRIPTION
  Record CRT live interactions as bounded Robot Framework lines

EXAMPLES
  $ agentia testing live recorder --project <project-id> --output recorded.robot
```

_See code: [src/commands/testing/live/recorder.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/recorder.ts)_

## `agentia testing live reports [JOB-ID]`

List or save bounded report artifacts from an active CRT live session

```
USAGE
  $ agentia testing live reports [JOB-ID] -p <value> [--json] [--session-id <value>] [--output-dir <value>]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -p, --project=<value>     (required) CRT project ID.
      --output-dir=<value>  Explicit directory for log.html, report.html, and output.xml.
      --session-id=<value>  Guard that must match the locally active CRT live session.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List or save bounded report artifacts from an active CRT live session

EXAMPLES
  $ agentia testing live reports --project <project-id>

  $ agentia testing live reports --project <project-id> --output-dir ./reports
```

_See code: [src/commands/testing/live/reports.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/reports.ts)_

## `agentia testing live screenshot [JOB-ID]`

Save a bounded CRT live browser screenshot to an explicit file

```
USAGE
  $ agentia testing live screenshot [JOB-ID] -p <value> -o <value> [--json] [--session-id <value>]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -o, --output=<value>      (required) Explicit screenshot output path.
  -p, --project=<value>     (required) CRT project ID.
      --session-id=<value>  Guard that must match the locally active CRT live session.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Save a bounded CRT live browser screenshot to an explicit file

EXAMPLES
  $ agentia testing live screenshot --project <project-id> --output screenshot.png
```

_See code: [src/commands/testing/live/screenshot.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/screenshot.ts)_

## `agentia testing live set-options [JOB-ID]`

Set the complete validated CRT live recorder option block

```
USAGE
  $ agentia testing live set-options [JOB-ID] -p <value> [--json] [--session-id <value>] [--enable] [--healing-context]
    [--hover-text] [--scroll-text] [--system-state] [--table-keywords] [--verify-text]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -p, --project=<value>       (required) CRT project ID.
      --[no-]enable           Enable or disable interaction recording.
      --[no-]healing-context  Capture recorder healing context.
      --[no-]hover-text       Capture HoverText interactions.
      --[no-]scroll-text      Capture ScrollText interactions.
      --session-id=<value>    Guard that must match the locally active CRT live session.
      --[no-]system-state     Capture console/network system state.
      --[no-]table-keywords   Prefer table-aware interaction keywords.
      --[no-]verify-text      Capture VerifyText interactions.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Set the complete validated CRT live recorder option block

EXAMPLES
  $ agentia testing live set-options --project <project-id> --enable --scroll-text --table-keywords
```

_See code: [src/commands/testing/live/set-options.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/set-options.ts)_

## `agentia testing live start JOB-ID`

Start and bootstrap a bounded Copado Robotic Testing live session

```
USAGE
  $ agentia testing live start JOB-ID -p <value> [--json] [--session-id <value>] [--description <value>] [--file
    <value>] [--jap-ime] [--library QWeb|QForce|QMobile] [--no-bootstrap] [--no-browser] [--poll-interval <value>]
    [--screen <value>] [--section <value>] [--section-index <value>] [--session-version <value>] [--timeout <value>]
    [--viewport <value>]

ARGUMENTS
  JOB-ID  CRT job ID.

FLAGS
  -p, --project=<value>          (required) CRT project ID.
      --description=<value>      Nonsecret session label.
      --file=<value>             Robot Framework file used to bootstrap a selected test/task.
      --jap-ime                  Enable Japanese IME in the live environment.
      --library=<option>         [default: QWeb] Robot Framework library to bootstrap.
                                 <options: QWeb|QForce|QMobile>
      --no-bootstrap             Create the host without readiness/bootstrap calls.
      --no-browser               Do not open Chrome during QWeb/QForce bootstrap.
      --poll-interval=<value>    [default: 3] Readiness polling interval in seconds.
      --screen=<value>           Session screen as WIDTHxHEIGHTxDEPTH.
      --section=<value>          Robot test/task name to bootstrap.
      --section-index=<value>    One-based Robot test/task index to bootstrap.
      --session-id=<value>       Guard that must match the locally active CRT live session.
      --session-version=<value>  CRT live environment version.
      --timeout=<value>          [default: 120] Readiness timeout in seconds.
      --viewport=<value>         Session viewport as WIDTHxHEIGHT (24-bit depth).

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Start and bootstrap a bounded Copado Robotic Testing live session

EXAMPLES
  $ agentia testing live start <job-id> --project <project-id>

  $ agentia testing live start <job-id> --project <project-id> --file smoke.robot --section "Login"
```

_See code: [src/commands/testing/live/start.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/start.ts)_

## `agentia testing live status [JOB-ID]`

Inspect sanitized status for the active CRT live session

```
USAGE
  $ agentia testing live status [JOB-ID] -p <value> [--json] [--session-id <value>]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -p, --project=<value>     (required) CRT project ID.
      --session-id=<value>  Guard that must match the locally active CRT live session.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Inspect sanitized status for the active CRT live session

EXAMPLES
  $ agentia testing live status --project <project-id> --json
```

_See code: [src/commands/testing/live/status.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/status.ts)_

## `agentia testing live stop [JOB-ID]`

Stop the active Copado Robotic Testing live session

```
USAGE
  $ agentia testing live stop [JOB-ID] -p <value> [--json] [--session-id <value>] [-y]

ARGUMENTS
  [JOB-ID]  Optional CRT job ID guard.

FLAGS
  -p, --project=<value>     (required) CRT project ID.
  -y, --yes                 Confirm live session shutdown.
      --session-id=<value>  Guard that must match the locally active CRT live session.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Stop the active Copado Robotic Testing live session

EXAMPLES
  $ agentia testing live stop --project <project-id>

  $ agentia testing live stop <job-id> --project <project-id> --yes --json
```

_See code: [src/commands/testing/live/stop.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/stop.ts)_

## `agentia testing live view`

Open the authenticated CRT run/session page without putting viewer secrets in the URL

```
USAGE
  $ agentia testing live view -p <value> [--json] [--session-id <value>] [--interactive] [--no-open]

FLAGS
  -p, --project=<value>     (required) CRT project ID.
      --interactive         Request interactive viewer controls when available.
      --no-open             Return the nonsecret URL without opening a browser.
      --session-id=<value>  Guard that must match the locally active CRT live session.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Open the authenticated CRT run/session page without putting viewer secrets in the URL

EXAMPLES
  $ agentia testing live view --project <project-id>

  $ agentia testing live view --project <project-id> --no-open --json
```

_See code: [src/commands/testing/live/view.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/live/view.ts)_

## `agentia testing project create`

Create a Copado Robotic Testing project

```
USAGE
  $ agentia testing project create --name <value> [--json] [--description <value>]

FLAGS
  --description=<value>  Project description.
  --name=<value>         (required) Project name.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado Robotic Testing project

EXAMPLES
  $ agentia testing project create --name "QA Tests"

  $ agentia testing project create --name "QA Tests" --description "Smoke suite" --json
```

_See code: [src/commands/testing/project/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/project/create.ts)_

## `agentia testing project delete ID`

Delete a Copado Robotic Testing project

```
USAGE
  $ agentia testing project delete ID [--json] [-y]

ARGUMENTS
  ID  CRT project ID.

FLAGS
  -y, --yes  Skip the destructive confirmation prompt.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado Robotic Testing project

EXAMPLES
  $ agentia testing project delete <project-id> --yes

  $ agentia testing project delete <project-id> --yes --json
```

_See code: [src/commands/testing/project/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/project/delete.ts)_

## `agentia testing project get ID`

Get a Copado Robotic Testing project from the project list

```
USAGE
  $ agentia testing project get ID [--json]

ARGUMENTS
  ID  CRT project ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado Robotic Testing project from the project list

EXAMPLES
  $ agentia testing project get <project-id>

  $ agentia testing project get <project-id> --json
```

_See code: [src/commands/testing/project/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/project/get.ts)_

## `agentia testing project list`

List Copado Robotic Testing projects

```
USAGE
  $ agentia testing project list [--json] [--name <value>]

FLAGS
  --name=<value>  Exact project name to match client-side.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado Robotic Testing projects

EXAMPLES
  $ agentia testing project list

  $ agentia testing project list --name "QA Tests" --json
```

_See code: [src/commands/testing/project/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/project/list.ts)_

## `agentia testing project permission get PROJECT`

Get the caller's permission on a Copado Robotic Testing project

```
USAGE
  $ agentia testing project permission get PROJECT [--json]

ARGUMENTS
  PROJECT  CRT project ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get the caller's permission on a Copado Robotic Testing project

EXAMPLES
  $ agentia testing project permission get <project-id>

  $ agentia testing project permission get <project-id> --json
```

_See code: [src/commands/testing/project/permission/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/project/permission/get.ts)_

## `agentia testing project permission list PROJECT`

List assignments for a Copado Robotic Testing project

```
USAGE
  $ agentia testing project permission list PROJECT [--json]

ARGUMENTS
  PROJECT  CRT project ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List assignments for a Copado Robotic Testing project

EXAMPLES
  $ agentia testing project permission list <project-id>

  $ agentia testing project permission list <project-id> --json
```

_See code: [src/commands/testing/project/permission/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/project/permission/list.ts)_

## `agentia testing project permission set PROJECT`

Set a user or group permission on a Copado Robotic Testing project

```
USAGE
  $ agentia testing project permission set PROJECT [--json] [--edit] [--group <value> | --user <value>] [--view]

ARGUMENTS
  PROJECT  CRT project ID.

FLAGS
  --edit           Grant edit access.
  --group=<value>  Platform group ID.
  --user=<value>   Platform user ID.
  --view           Grant view access.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Set a user or group permission on a Copado Robotic Testing project

EXAMPLES
  $ agentia testing project permission set <project-id> --user <user-id> --view

  $ agentia testing project permission set <project-id> --group <group-id> --view --edit --json
```

_See code: [src/commands/testing/project/permission/set.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/project/permission/set.ts)_

## `agentia testing project permission update PROJECT`

Update a user or group permission on a Copado Robotic Testing project

```
USAGE
  $ agentia testing project permission update PROJECT [--json] [--edit] [--group <value> | --user <value>] [--view]

ARGUMENTS
  PROJECT  CRT project ID.

FLAGS
  --edit           Set edit access.
  --group=<value>  Platform group ID.
  --user=<value>   Platform user ID.
  --view           Set view access.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a user or group permission on a Copado Robotic Testing project

EXAMPLES
  $ agentia testing project permission update <project-id> --user <user-id> --view --edit

  $ agentia testing project permission update <project-id> --group <group-id> --view --json
```

_See code: [src/commands/testing/project/permission/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/project/permission/update.ts)_

## `agentia testing project update ID`

Update a Copado Robotic Testing project

```
USAGE
  $ agentia testing project update ID [--json] [--description <value>] [--name <value>]

ARGUMENTS
  ID  CRT project ID.

FLAGS
  --description=<value>  New project description.
  --name=<value>         New project name.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado Robotic Testing project

EXAMPLES
  $ agentia testing project update <project-id> --name "QA Updated"

  $ agentia testing project update <project-id> --description "Regression suites" --json
```

_See code: [src/commands/testing/project/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/project/update.ts)_

## `agentia testing robot create`

Create a Copado Robotic Testing robot

```
USAGE
  $ agentia testing robot create -p <value> --name <value> [--json] [--description <value>] [--fw-version <value>]
    [--label <value>] [--reporting all|nothing] [--robot-type bitbar|browserstack|browserstackdesktop|default|lambdatest
    |lambdatestdesktop|mobile|pabot|paceconnectmobile|privatemobile] [--run-environment cloud|QConnect]

FLAGS
  -p, --project=<value>
      (required) CRT project ID.

  --description=<value>
      Description for the robot (defaults to empty if omitted).

  --fw-version=<value>
      [default: stable] Test framework release channel (for example stable).

  --label=<value>
      Optional label for the robot.

  --name=<value>
      (required) Name for the new robot.

  --reporting=<option>
      Which test results to keep after a run (all or nothing); only in effect when QConnect is used:
      - all: Keep all test results from the robot's runs
      - nothing: Do not keep any test results
      <options: all|nothing>

  --robot-type=<option>
      [default: default] What kind of tests the robot runs:
      - bitbar: Run mobile tests on BitBar cloud devices
      - browserstack: Run mobile tests on BrowserStack cloud devices
      - browserstackdesktop: Run desktop browser tests on BrowserStack
      - default: Standard robot for web and desktop tests (the usual choice)
      - lambdatest: Run mobile tests on LambdaTest cloud devices
      - lambdatestdesktop: Run desktop browser tests on LambdaTest
      - mobile: Run mobile tests on cloud-hosted devices
      - pabot: Run test suites in parallel
      - privatemobile: Run mobile tests on your own private devices
      - paceconnectmobile: Run mobile tests through a self-hosted agent in your own network
      <options: bitbar|browserstack|browserstackdesktop|default|lambdatest|lambdatestdesktop|mobile|pabot|paceconnectmobil
      e|privatemobile>

  --run-environment=<option>
      [default: cloud] Where the robot's tests run:
      - cloud: Run tests on cloud machines hosted by Copado (the usual choice)
      - QConnect: Run tests on a self-hosted agent installed in your own network
      <options: cloud|QConnect>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado Robotic Testing robot

EXAMPLES
  $ agentia testing robot create --project <project-id> --name "Cloud Robot"

  $ agentia testing robot create --project <project-id> --name "QConnect Robot" --run-environment QConnect --json
```

_See code: [src/commands/testing/robot/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/robot/create.ts)_

## `agentia testing robot delete ID`

Delete a Copado Robotic Testing robot

```
USAGE
  $ agentia testing robot delete ID -p <value> [--json] [-y]

ARGUMENTS
  ID  CRT robot ID.

FLAGS
  -p, --project=<value>  (required) CRT project ID.
  -y, --yes              Skip the destructive confirmation prompt.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado Robotic Testing robot

EXAMPLES
  $ agentia testing robot delete <robot-id> --project <project-id> --yes

  $ agentia testing robot delete <robot-id> --project <project-id> --yes --json
```

_See code: [src/commands/testing/robot/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/robot/delete.ts)_

## `agentia testing robot get ID`

Get a Copado Robotic Testing robot from the project robot list

```
USAGE
  $ agentia testing robot get ID -p <value> [--json]

ARGUMENTS
  ID  CRT robot ID.

FLAGS
  -p, --project=<value>  (required) CRT project ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado Robotic Testing robot from the project robot list

EXAMPLES
  $ agentia testing robot get <robot-id> --project <project-id>

  $ agentia testing robot get <robot-id> --project <project-id> --json
```

_See code: [src/commands/testing/robot/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/robot/get.ts)_

## `agentia testing robot list`

List Copado Robotic Testing robots in a project

```
USAGE
  $ agentia testing robot list -p <value> [--json]

FLAGS
  -p, --project=<value>  (required) CRT project ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado Robotic Testing robots in a project

EXAMPLES
  $ agentia testing robot list --project <project-id>

  $ agentia testing robot list --project <project-id> --json
```

_See code: [src/commands/testing/robot/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/robot/list.ts)_

## `agentia testing robot update ID`

Update a Copado Robotic Testing robot

```
USAGE
  $ agentia testing robot update ID -p <value> [--json] [--description <value>] [--fw-version <value>] [--label <value>]
    [--name <value>] [--reporting all|nothing] [--robot-type bitbar|browserstack|browserstackdesktop|default|lambdatest|
    lambdatestdesktop|mobile|pabot|paceconnectmobile|privatemobile]

ARGUMENTS
  ID  CRT robot ID.

FLAGS
  -p, --project=<value>
      (required) CRT project ID.

  --description=<value>
      New robot description.

  --fw-version=<value>
      New Robot Framework release channel.

  --label=<value>
      New robot label.

  --name=<value>
      New robot name.

  --reporting=<option>
      Which test results to keep after a run (all or nothing); only in effect when QConnect is used:
      - all: Keep all test results from the robot's runs
      - nothing: Do not keep any test results
      <options: all|nothing>

  --robot-type=<option>
      What kind of tests the robot runs:
      - bitbar: Run mobile tests on BitBar cloud devices
      - browserstack: Run mobile tests on BrowserStack cloud devices
      - browserstackdesktop: Run desktop browser tests on BrowserStack
      - default: Standard robot for web and desktop tests (the usual choice)
      - lambdatest: Run mobile tests on LambdaTest cloud devices
      - lambdatestdesktop: Run desktop browser tests on LambdaTest
      - mobile: Run mobile tests on cloud-hosted devices
      - pabot: Run test suites in parallel
      - privatemobile: Run mobile tests on your own private devices
      - paceconnectmobile: Run mobile tests through a self-hosted agent in your own network
      <options: bitbar|browserstack|browserstackdesktop|default|lambdatest|lambdatestdesktop|mobile|pabot|paceconnectmobil
      e|privatemobile>

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado Robotic Testing robot

EXAMPLES
  $ agentia testing robot update <robot-id> --project <project-id> --name "Updated Robot"

  $ agentia testing robot update <robot-id> --project <project-id> --robot-type default --json
```

_See code: [src/commands/testing/robot/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/robot/update.ts)_

## `agentia testing user-parameter create`

Create an account-scoped Copado Robotic Testing user parameter

```
USAGE
  $ agentia testing user-parameter create --key <value> [--json] [--description <value>] [--sensitive] [--type parameter]
    [--unique] [--no-trim | --trim] [--value <value> | --value-file <value> | --value-stdin]

FLAGS
  --description=<value>  Parameter description.
  --key=<value>          (required) Parameter key.
  --no-trim              Preserve leading and trailing whitespace in the supplied value.
  --[no-]sensitive       Mark the parameter as sensitive.
  --trim                 Trim leading and trailing whitespace (the default policy).
  --type=<option>        [default: parameter] CRT user-parameter type.
                         <options: parameter>
  --unique               Reject an existing parameter with the same key.
  --value=<value>        Value supplied directly. Prefer file/stdin for sensitive values.
  --value-file=<value>   Read the value from a bounded regular file.
  --value-stdin          Read the value from stdin.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create an account-scoped Copado Robotic Testing user parameter

EXAMPLES
  $ agentia testing user-parameter create --key BASE_URL --value https://example.com

  $ agentia testing user-parameter create --key TOKEN --value-stdin --sensitive --unique --json
```

_See code: [src/commands/testing/user-parameter/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/user-parameter/create.ts)_

## `agentia testing user-parameter delete ID`

Delete an account-scoped Copado Robotic Testing user parameter

```
USAGE
  $ agentia testing user-parameter delete ID [--json] [-y]

ARGUMENTS
  ID  CRT user-parameter ID.

FLAGS
  -y, --yes  Skip the destructive confirmation prompt.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete an account-scoped Copado Robotic Testing user parameter

EXAMPLES
  $ agentia testing user-parameter delete <parameter-id> --yes

  $ agentia testing user-parameter delete <parameter-id> --yes --json
```

_See code: [src/commands/testing/user-parameter/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/user-parameter/delete.ts)_

## `agentia testing user-parameter get ID`

Get an account-scoped Copado Robotic Testing user parameter

```
USAGE
  $ agentia testing user-parameter get ID [--json]

ARGUMENTS
  ID  CRT user-parameter ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get an account-scoped Copado Robotic Testing user parameter

EXAMPLES
  $ agentia testing user-parameter get <parameter-id>

  $ agentia testing user-parameter get <parameter-id> --json
```

_See code: [src/commands/testing/user-parameter/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/user-parameter/get.ts)_

## `agentia testing user-parameter list`

List account-scoped Copado Robotic Testing user parameters

```
USAGE
  $ agentia testing user-parameter list [--json] [--job <value>] [--key <value>] [--project <value>]

FLAGS
  --job=<value>      Defensive client-side job scope filter.
  --key=<value>      Exact parameter key filter.
  --project=<value>  Defensive client-side project scope filter.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List account-scoped Copado Robotic Testing user parameters

EXAMPLES
  $ agentia testing user-parameter list

  $ agentia testing user-parameter list --key BASE_URL --json
```

_See code: [src/commands/testing/user-parameter/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/user-parameter/list.ts)_

## `agentia testing user-parameter update ID`

Update an account-scoped Copado Robotic Testing user parameter

```
USAGE
  $ agentia testing user-parameter update ID [--json] [--description <value>] [--key <value>] [--unique] [--no-trim | --trim]
    [--value <value> | --value-file <value> | --value-stdin]

ARGUMENTS
  ID  CRT user-parameter ID.

FLAGS
  --description=<value>  New parameter description.
  --key=<value>          New parameter key.
  --no-trim              Preserve leading and trailing whitespace in the supplied value.
  --trim                 Trim leading and trailing whitespace (the default policy).
  --unique               Reject another parameter with the same new key.
  --value=<value>        Value supplied directly. Prefer file/stdin for sensitive values.
  --value-file=<value>   Read the value from a bounded regular file.
  --value-stdin          Read the value from stdin.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update an account-scoped Copado Robotic Testing user parameter

EXAMPLES
  $ agentia testing user-parameter update <parameter-id> --description "Updated"

  $ agentia testing user-parameter update <parameter-id> --value-file ./value.txt --no-trim --json
```

_See code: [src/commands/testing/user-parameter/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/user-parameter/update.ts)_

## `agentia testing variable create`

Create a Copado Robotic Testing variable/secret

```
USAGE
  $ agentia testing variable create -p <value> --key <value> [--json] [--description <value>] [--job <value> | --robot
    <value>] [--sensitive] [--type clp|config|dataset|secret] [--user-specific] [--no-trim | --trim] [--value <value> |
    --value-file <value> | --value-stdin]

FLAGS
  -p, --project=<value>      (required) CRT project ID.
      --description=<value>  Variable description.
      --job=<value>          Scope the variable to a CRT job ID.
      --key=<value>          (required) Variable key.
      --no-trim              Preserve leading and trailing whitespace in the supplied value.
      --robot=<value>        Scope the variable to a CRT robot ID.
      --[no-]sensitive       Mark the variable as sensitive.
      --trim                 Trim leading and trailing whitespace (the default policy).
      --type=<option>        [default: secret] CRT variable type.
                             <options: clp|config|dataset|secret>
      --user-specific        Create a user-specific variable.
      --value=<value>        Value supplied directly. Prefer file/stdin for sensitive values.
      --value-file=<value>   Read the value from a bounded regular file.
      --value-stdin          Read the value from stdin.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a Copado Robotic Testing variable/secret

EXAMPLES
  $ agentia testing variable create --project <project-id> --key BASE_URL --value https://example.com

  $ agentia testing variable create --project <project-id> --key TOKEN --value secret --sensitive --json
```

_See code: [src/commands/testing/variable/create.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/variable/create.ts)_

## `agentia testing variable delete ID`

Delete a Copado Robotic Testing variable/secret

```
USAGE
  $ agentia testing variable delete ID -p <value> [--json] [-y]

ARGUMENTS
  ID  CRT variable/secret ID.

FLAGS
  -p, --project=<value>  (required) CRT project ID.
  -y, --yes              Skip the destructive confirmation prompt.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Delete a Copado Robotic Testing variable/secret

EXAMPLES
  $ agentia testing variable delete <variable-id> --project <project-id> --yes

  $ agentia testing variable delete <variable-id> --project <project-id> --yes --json
```

_See code: [src/commands/testing/variable/delete.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/variable/delete.ts)_

## `agentia testing variable get ID`

Get a Copado Robotic Testing variable/secret

```
USAGE
  $ agentia testing variable get ID -p <value> [--json]

ARGUMENTS
  ID  CRT variable/secret ID.

FLAGS
  -p, --project=<value>  (required) CRT project ID.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get a Copado Robotic Testing variable/secret

EXAMPLES
  $ agentia testing variable get <variable-id> --project <project-id>

  $ agentia testing variable get <variable-id> --project <project-id> --json
```

_See code: [src/commands/testing/variable/get.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/variable/get.ts)_

## `agentia testing variable list`

List Copado Robotic Testing variables/secrets

```
USAGE
  $ agentia testing variable list -p <value> [--json] [--job <value> | --robot <value>] [--key <value>] [--sensitive]
    [--type clp|config|dataset|secret] [--user-specific]

FLAGS
  -p, --project=<value>     (required) CRT project ID.
      --job=<value>         Filter for a CRT job ID.
      --key=<value>         Filter by exact variable key.
      --robot=<value>       Filter for a CRT robot ID.
      --[no-]sensitive      Filter by sensitive status.
      --type=<option>       Filter by CRT variable type.
                            <options: clp|config|dataset|secret>
      --[no-]user-specific  Filter by user-specific status.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List Copado Robotic Testing variables/secrets

EXAMPLES
  $ agentia testing variable list --project <project-id>

  $ agentia testing variable list --project <project-id> --job <job-id> --json
```

_See code: [src/commands/testing/variable/list.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/variable/list.ts)_

## `agentia testing variable update ID`

Update a Copado Robotic Testing variable/secret

```
USAGE
  $ agentia testing variable update ID -p <value> [--json] [--description <value>] [--key <value>] [--not-sensitive]
    [--sensitive] [--type clp|config|dataset|secret] [--no-trim | --trim] [--value <value> | --value-file <value> |
    --value-stdin]

ARGUMENTS
  ID  CRT variable/secret ID.

FLAGS
  -p, --project=<value>      (required) CRT project ID.
      --description=<value>  Variable description.
      --key=<value>          Variable key.
      --no-trim              Preserve leading and trailing whitespace in the supplied value.
      --not-sensitive        Mark the variable as not sensitive.
      --[no-]sensitive       Mark the variable as sensitive.
      --trim                 Trim leading and trailing whitespace (the default policy).
      --type=<option>        CRT variable type.
                             <options: clp|config|dataset|secret>
      --value=<value>        Value supplied directly. Prefer file/stdin for sensitive values.
      --value-file=<value>   Read the value from a bounded regular file.
      --value-stdin          Read the value from stdin.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a Copado Robotic Testing variable/secret

EXAMPLES
  $ agentia testing variable update <variable-id> --project <project-id> --value https://example.com

  $ agentia testing variable update <variable-id> --project <project-id> --not-sensitive --json
```

_See code: [src/commands/testing/variable/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/testing/variable/update.ts)_

## `agentia update`

Update the globally installed Agentia CLI to the newest release for the selected channel

```
USAGE
  $ agentia update [--json] [--channel rc|latest] [--check]

FLAGS
  --channel=<option>  npm dist-tag to check or install (rc or latest). Also saves that channel as the preferred update
                      channel when an install runs. Omit to auto-select from the stored preference or install type:
                      prerelease installs and an rc preference compare rc and latest; stable installs with a latest
                      preference (or no preference) use latest only.
                      <options: rc|latest>
  --check             Check for an update without installing it or changing the preferred channel

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update the globally installed Agentia CLI to the newest release for the selected channel

EXAMPLES
  $ agentia update

  $ agentia update --check

  $ agentia update --channel latest --check

  $ agentia update --channel rc

  $ agentia update --check --json
```

_See code: [src/commands/update.ts](https://github.com/Copado/agentia-cli/blob/v1.2.0/src/commands/update.ts)_
<!-- commandsstop -->