Kognyt

VS Code

Metadata Workflows

Retrieve, deploy, validate, and inspect metadata drift from the active Astra org inside your workspace.

Astra includes command-driven metadata workflows tied to the active org.

Commands

  • Kognyt: Retrieve Metadata
  • Kognyt: Deploy Metadata
  • Kognyt: Validate Metadata Deployment
  • Kognyt: Inspect Metadata Drift

Retrieve

Kognyt: Retrieve Metadata pulls metadata from the active org into the current workspace.

  • If you do not provide components, Astra looks for manifest/package.xml first, then package.xml.
  • If no package file is found, retrieve fails and asks you to create one or provide package_xml_path.

Deploy and validate

Kognyt: Deploy Metadata deploys local metadata from the workspace to the active org.

Kognyt: Validate Metadata Deployment runs a check-only deploy with RunLocalTests.

Before deploy or validate, Astra prepares a preflight summary and asks for confirmation.

Drift inspection

Kognyt: Inspect Metadata Drift compares local metadata with the active org and Astra's recorded sync baseline. Results classify metadata as:

  • local-only
  • org-only
  • in-sync
  • diverged

Execution backends

Astra supports two metadata backends:

  • yantra (default)
  • localSfCli (opt-in)

If you switch to localSfCli, set astra.sfCliTargetOrg. Astra verifies that the CLI target's org ID and instance URL match the active Astra org before retrieve or deploy runs.

Previous

AI Tool Integration

Next

Troubleshooting