Agentia IDE

Bring Copado and Agentia delivery workflows into VS Code and Cursor. Agentia IDE gives developers one place to manage work items, deployments, pipelines, environments, data, jobs, promotions, and CRT testing while keeping authentication in the Agentia CLI.

Agentia IDE is currently distributed as a controlled pre-release. It requires access to Copado services and the local Agentia CLI.

What you can do

Keep each delivery story moving

Start from the Agentia activity bar: choose a current story, see delivery context in the status bar, and complete daily work without repeatedly switching to a browser.

• View the current story and available work items.
• Create stories, push changes, validate, and promote and deploy.
• Manage deployment steps for flows, functions, data templates, and robotic tests.

Before promotion, inspect exactly what a change depends on. Related Metadata separates dependency health from Git provenance so that a missing item, a local change, and an item already committed on the branch are not confused.

Follow deployments and resolve blockers

Follow job progress in the editor, open saved step logs, and handle promotion work while it is actionable.

• Track jobs and open step logs in VS Code.
• Search promotions, resume eligible deployments, and resolve promotion conflicts.

Understand the delivery platform

Inspect the connected pipeline and environment topology before making a change. Repository, Function, Pipeline, and Environment views bring the operational configuration into the same IDE workflow.

• Browse repositories and pipelines, inspect connections, and validate configuration.
• Manage environments, credentials, defaults, and metadata indexes.

Ship trusted data and tests

Manage data and automated testing as part of the same story—not as a separate hand-off.

• Explore Copado data templates and parent/child relationships.
• Preview records and create data commits under the active story.
• Edit CRT Robot Framework files locally, upload on save, launch runs, follow logs, and download results.

Quick start

1. Install the Agentia CLI:

   npm install --global @copado/agentia-cli
   

2. Open a trusted workspace in VS Code or Cursor.

3. Open the Agentia activity bar and complete Agentia IDE setup.

4. Configure the CLI and Copado credentials when prompted.

5. Open Work and select or create the story you want to manage.

Authentication and credentials remain in the Agentia CLI boundary. Agentia IDE does not store API keys, PATs, OAuth signatures, or passwords in workspace settings.

Requirements

• VS Code 1.101 or newer, or a compatible editor such as Cursor.
• Node.js 22.12 or newer.
• Agentia CLI installed and available to the editor process.
• Copado access configured through the Agentia CLI.
• CRT users need separate CRT credentials configured through the Testing setup.

The Agentia activity bar

The activity bar can show:

• Work — stories, deployment steps, related metadata, and data commits.
• Jobs — executions, progress, and step logs.
• Promotions — current and other promotions, details, resume, and conflicts.
• Repositories — repository configuration, validation, and snapshots.
• Functions — Copado Functions, script editing, local runs, and remote runs.
• Pipelines — pipelines, environment connections, and details.
• Environments — environments, credentials, defaults, and metadata indexes.
• Data — data templates, explorers, previews, and commits.
• Testing (CRT) — projects, robots, jobs, runs, and variables.

Use Agentia: Panel visibility settings to show or hide sections. The Agentia status bar shows the current story context.

Configuration

Useful settings include:

• agentia.cliPath — the Agentia executable used by the extension.
• agentia.showStatusBar — toggle status-bar context.
• agentia.showWork, agentia.showJobs, agentia.showPromotions, agentia.showRepositories, agentia.showFunctions, agentia.showPipeline, agentia.showEnvironments, agentia.showData, and agentia.showTesting — control activity-bar sections.
• agentia.testing.autoUploadOnSave — upload tracked CRT files when saved.
• agentia.testing.localWorkspaceDir — choose the local CRT workspace directory.
• agentia.testing.pollIntervalSeconds — control CRT run polling.

If the CLI works in a terminal but setup cannot find it, set agentia.cliPath to the absolute path returned by which agentia, then reload the editor.

Troubleshooting

• The setup view says the CLI is missing: install the Agentia CLI and reload the editor.
• The CLI works in a terminal but not in the editor: configure agentia.cliPath with an absolute path.
• A view is hidden: run Agentia: Panel visibility settings or enable its agentia.show* setting.
• CRT is unavailable: configure CRT credentials separately from CICD credentials.
• A Copado action fails: review the sanitized message, confirm CLI authentication, and retry from the relevant details view.

Support

Use your organization's Copado support channel for access, authentication, and product questions. Marketplace reviews should not contain credentials or customer data.