SFDX Hardis for Visual Studio Code

The complete Salesforce DX toolkit - for everyone. A click-driven UI on top of the sfdx-hardis CLI: deliver Salesforce projects with a state-of-the-art DevOps pipeline, monitor your orgs, generate AI-assisted documentation, and run hundreds of productivity commands - without having to learn Salesforce DX or Git first.

Built and maintained by Cloudity and the Trailblazer Community. Free, Open Source (AGPL-3.0), and commercial use allowed.

▶ Watch the sfdx-hardis v7 walkthrough · ▶ Watch the Dreamforce session · 📖 Online documentation

Why VS Code SFDX Hardis?

Salesforce DX is powerful, but you have to glue together dozens of sf commands, plugins, YAML files, and Git operations to ship a project safely. VS Code SFDX Hardis turns that toolbox into an integrated workspace:

🖱️ Click, don't memorize - every operation is a button with sensible defaults, tooltips, and contextual help.
🚦 CI/CD-ready from day one - set up a complete Salesforce CI/CD pipeline and visualize it inside VS Code.
🩺 Watch your orgs - monitor production and sandbox health, security, and limits, with notifications to Slack, MS Teams, email, Jira, Grafana…
📚 AI-generated documentation - turn your metadata into a browsable, diagram-rich knowledge base.
🤝 Native integrations - GitHub, GitLab, Azure DevOps, Bitbucket, Gitea · Jira, Azure Boards, ServiceNow, Aha! · Slack, MS Teams, Email · OpenAI, Anthropic, Agentforce, Ollama…

Who is it for?

Role	What you get
Salesforce Consultants / Admins	A guided, Git-free UI to build user stories, pull changes, and publish work without touching the command line.
Developers	Power-user shortcuts: anonymous Apex runner, debugger, delta deployment simulation, project cleaning, Flow git diff, package management.
Release Managers / Architects	A visual pipeline, deployment simulation, branch-strategy diagrams, and full org monitoring with notifications.
CTOs / Project sponsors	Open-Source tooling that standardizes DevOps across teams and makes Salesforce delivery auditable.

Installation

Install Visual Studio Code (or any VS Code-compatible IDE, see below).
Install the SFDX Hardis extension (or from Open VSX).
Click the Hardis icon in the VS Code Activity Bar, then Install dependencies - the extension installs and updates everything for you (@salesforce/cli, sfdx-hardis, SFDMU, sfdx-git-delta, Browserforce…).

Works in every VS Code-compatible IDE

SFDX Hardis is published on both the Visual Studio Marketplace and the Open VSX Registry, so it is fully compatible with every VS Code-based IDE, on desktop or in the browser:

	IDE	Install from
	Visual Studio Code	Visual Studio Marketplace
	Agentforce Vibes IDE and other browser IDEs	Open VSX
	Cursor	Open VSX
	Windsurf	Open VSX
	VSCodium and other VS Code forks	Open VSX

The only requirement is the same as for VS Code: the IDE must be able to run the Salesforce CLI (Agentforce Vibes IDE ships it preinstalled).

Learn by doing

Salesforce DevOps with sfdx-hardis is a free hands-on course that builds a complete CI/CD pipeline on free orgs, one click at a time.

Level 1 - Contributor basics: 7 labs, from your first User Story to a merged Pull Request
Level 2 - Contributor advanced: 9 labs, deployment errors, deployment actions, code quality, conflicts
Level 3 - Release Manager: 11 labs, the pipeline up to production, releases, hotfixes, monitoring

Feature tour

Unified Welcome panel

A single dashboard that gives one-click access to every workbench, with localized labels, light/dark theme switching, and your favorite custom menus pinned alongside the built-ins.

Orgs Manager

Connect to new orgs, switch between sandboxes, scratch orgs and Dev Hubs, clean up stale authentications - all from one panel. Token and URL handling is performed safely by the sfdx-hardis CLI; nothing sensitive is ever displayed or logged.

DevOps Pipeline (CI/CD)

Visualize and manage your entire CI/CD pipeline inside VS Code: branches, environments, automated deployments, merge checks, delta deployment - everything in one screen.

The pipeline supports the major Git platforms out of the box: GitHub, GitLab, Azure DevOps, Bitbucket, Gitea - with merge-request comments, Jira / Azure Boards / ServiceNow / Aha! integration, and notifications to Slack, MS Teams and Email.

User Story workflow

Designed for consultant profiles: start a user story → work in the org → save & publish without ever opening a terminal.

New user story	Retrieve & commit	Save & publish

Start a new user story - branches and configures everything for you.
Pull from org - retrieves only what you actually changed.
Save / publish - cleans sources, commits, and opens the merge request.

Promotion branches (Beta)

Ship the approved User Stories of a branch without waiting for the rest of the window. Open a major branch in the DevOps Pipeline, tick the stories business signed off, and click Create promotion: the branch is assembled by cherry-pick, its Pull Request declares what it carries, and the deployment jobs give those stories their deployment actions, Apex test classes and tickets as if they had been merged directly. When a cherry-pick conflicts, the recommended answer commits every conflict at once and hands you a ready-to-paste prompt for your coding agent, which solves them all in a single pass.

Promotion branches - when to use one, how to assemble it, and what the jobs do with it.

Backpromote (Beta)

Deploy into your developer sandbox what your teammates merged in the parent branch since your last backpromote. The panel lists the merged Pull Requests, the metadata, the deletions and the deployment actions, and compares each item with your sandbox. For an item that differs, choose Overwrite, Keep org version or Merge. Merge opens the VS Code merge editor, and Merge all copies one prompt for your coding agent. Each Pull Request records the backpromote in a comment, so the next one starts where this one ended.

Merge all	Result

Backpromote to your dev sandbox - how it works, from VS Code and from a terminal.

Metadata Retriever

A modern replacement for the standard Org Browser. Filter by type, name, last modified by, last modified date, managed package, multi-select and retrieve in a single click.

Metadata presets

Instead of searching one metadata type at a time, select a preset to query a whole group of types at once. Two presets are available out of the box:

Developer Metadata: ApexClass, ApexTrigger, AuraDefinitionBundle, CustomLabel, CustomMetadata, Flow, LightningComponentBundle, StaticResource.
General Metadata: ApexClass, ApexTrigger, AuraDefinitionBundle, CustomField, CustomLabel, CustomMetadata, CustomObject, FlexiPage, Flow, GlobalValueSet, Layout, LightningComponentBundle, ListView, PermissionSet, PermissionSetGroup, QuickAction, RecordType, StaticResource, ValidationRule,

Presets are configurable in your project .sfdx-hardis.yml (root or config/ folder). Click Manage Presets in the panel to open the file: if it does not define any preset yet, the default ones are written into it, ready to be edited. Presets are reloaded as soon as you save the file.

metadataRetrieverPresets:
  - id: developerMetadata # a preset reusing a default id overrides that default preset
    label: Developer Metadata
    description: Apex, Flows and Lightning components
    types:
      - ApexClass
      - ApexTrigger
      - Flow
      - LightningComponentBundle
  - id: securityMetadata
    label: Security Metadata
    types:
      - PermissionSet
      - PermissionSetGroup
      - Profile
      - SharingRules

# Set to true to hide the presets shipped with the extension
metadataRetrieverPresetsOverrideDefaults: false

Metadata Dependencies

Find which components of an org use an Apex class, a Flow, a field, a layout or any other metadata, or which components it uses: the Used by / Uses switch reads the selected component either way. Open it from the row menu of the Metadata Retriever, the right-click menu of a metadata file (in the Explorer or in the file itself), the Commands menu or the Org Monitoring page.

From the list, open the local file of a component or its page in Setup (Flow Builder for a Flow), drill down to what uses it or to what it uses, retrieve the selected ones into your project, and generate a CSV/Excel report. Dependencies are read from the org, so a change that is not deployed yet is not included.

Data Workbench (SFDMU)

Import and export records between orgs using the Salesforce Data Move Utility (SFDMU), with full visual configuration support.

Create export/import configurations
Export / Import data with one click

Files Workbench

Mass-download or upload files and attachments between orgs from a guided UI - no scripting required.

Documentation Workbench

Generate a complete, AI-enriched knowledge base of your Salesforce project: Apex, Flows, profiles, permission sets, custom objects, with relationship diagrams.

Deploy the docs to GitHub Pages, Cloudflare Pages, Salesforce, or Confluence - straight from the workbench.

Org Monitoring

Set up scheduled monitoring jobs to track your Salesforce orgs over time: metadata backup, legacy API usage, unused metadata / licenses / Apex, audit trail anomalies, inactive users, missing attributes, release updates, health checks, limits…

Results can be pushed to Slack, MS Teams, Email, Jira, Grafana / Prometheus, or browsed as Excel reports.

Data Dictionary

Generate a Data Dictionary documenting all your org objects and fields as a navigable Excel workbook: an index sheet listing every object with its label, field count, validation rules, record types and key prefix, plus one detailed sheet per object describing each field (type, required, unique, references, picklist values, default value, formula…).

Monitoring Config Workbench

Edit triggers, frequency, and notification channels for every monitoring command in a single visual editor - no YAML editing required.

Pipeline Settings

A dedicated workbench to configure your CI/CD pipeline behavior: manual deployment actions, org authentication modes, branch strategies, deployment overrides, cleaning rules - all backed by the JSON-schema-validated .sfdx-hardis.yml.

Installed Packages Manager

List, install, update, and register installed packages into your CI/CD pipeline so every environment stays in sync.

Run Anonymous Apex & Apex Debugger

Run Anonymous Apex directly in VS Code, like the Developer Console.
Apex Debugger shortcuts: activate replay debug, toggle checkpoints, tail logs, and display only debug log lines.

Flow Visual Git Diff

Compare two versions of a Salesforce Flow as a side-by-side visual diagram - see what changed at a glance, instead of squinting at XML.

Productivity commands

Hundreds of ready-to-use commands organized in themed menus - Operations, Audit, Configuration, Packaging, Nerdy stuff - each with a help button that opens the official documentation.

A few favorites:

Freeze / unfreeze users during a deployment
Purge obsolete Flow versions
Reactivate .invalid user emails in a sandbox
Detect legacy API usage
Simulate a deployment
Clean SFDX project from unwanted references
Create and manage Package V2 (managed & unlocked)
Generate package.xml from Git diff with sfdx-git-delta

AI assistance

sfdx-hardis ships with an AI assistant that explains deployment errors, suggests fixes, and helps you understand legacy metadata. Bring your own provider: OpenAI, Anthropic, Salesforce Agentforce, Ollama - full control on which traffic leaves your machine.

See: AI setup · AI prompts

Commands tree & status panels

In addition to the workbenches, the extension contributes three classic tree views in the side bar:

Commands - every sfdx-hardis command, organized by menu, with help links and shortcut buttons (refresh, debugger, configuration files).
Status - current default org, Dev Hub, Git repo, branch, and org expiration date.
Plugins - checks that all CLI dependencies are present and up to date, and offers a one-click upgrade if not.

Per-org VS Code colors

VS Code is tinted according to the selected default org, so you never confuse Production with a sandbox, and a badge in the status bar always spells out which kind of org you are working on:

Org type	Badge	Color
Production	🛡️ PROD	red
Major org (UAT, integration…)	⚖️ MAJOR	orange
Dev sandbox	🧪 SANDBOX	green
Scratch org	🚀 SCRATCH	cyan
Other (Dev org, trial…)	☁️ DEV ORG	blue

The colors come from the same design system palette as the extension panels, and adapt to your light or dark theme. High contrast themes are never recolored, so accessibility settings stay intact.

Choose how much of the window is colored with vsCodeSfdxHardis.orgColorMode:

accent (default) - status bar and activity indicators only
tinted - also tints the title bar
full - also fills the activity bar
off - never change VS Code colors

You can override a color per org, or per URL pattern (e.g. https://*.scratch.my.salesforce.com): run Select color for current org and pick one from the palette, previewed live. Use vsCodeSfdxHardis.colorUpdateLocation to apply the change to your workspace or user settings, and vsCodeSfdxHardis.showOrgStatusBarItem to hide the status bar badge.

Multi-language UI

The whole extension UI is translated into English, French, Spanish, German, Italian, Dutch, Polish, Japanese, and Brazilian Portuguese. Switch language from the Welcome panel - VS Code auto-detection is also supported.

Customize the extension

Custom commands

Add your own menus and buttons to the Commands panel and Welcome dashboard via .sfdx-hardis.yml:

customCommandsPosition: first   # or "last" (default)
customCommands:
  - id: custom-menu
    label: My custom commands
    description: Shortcuts used by my team
    vscodeIcon: symbol-misc     # any VS Code ThemeIcon id
    sldsIcon: utility:apps      # any SLDS icon "category:name"
    commands:
      - id: generate-manifest-xml
        label: Generate manifest
        icon: file.svg          # any SVG in /resources
        vscodeIcon: file
        sldsIcon: utility:file
        tooltip: Generates a manifest package.xml from local sources
        command: sf project generate manifest --source-dir force-app --name myNewManifest
        helpUrl: https://sfdx-hardis.cloudity.com/
      - id: list-all-orgs
        label: List all orgs
        icon: salesforce.svg
        tooltip: List all authenticated orgs
        command: sf org list --all

Configurations can live in config/.sfdx-hardis.yml, in an absolute local path, or behind an HTTPS URL - perfect for sharing a common toolkit across your team.

Custom plugins

Make the Plugins panel monitor extra Salesforce CLI plugins:

plugins:
  - name: mo-dx-plugin
    helpUrl: https://github.com/msrivastav13/mo-dx-plugin
  - name: shane-sfdx-plugins
    helpUrl: https://github.com/mshanemc/shane-sfdx-plugins

Articles & talks

Français

Open Source dependencies

sfdx-hardis builds on top of these excellent Open Source projects:

Telemetry & privacy

To help prioritize features, anonymous usage statistics are sent to Azure Application Insights via @vscode/extension-telemetry, strictly following the VS Code Telemetry Guidelines.

We collect only:

Extension startup time
Command names invoked, limited to the first two segments (e.g. sf hardis:work:new, sf plugins:install)

We never collect command arguments, output, org URLs, tokens, usernames, or any business data. You can opt out at any time in VS Code settings.

Who we are

VS Code SFDX Hardis is graciously provided by Cloudity, an international Salesforce consulting partner, and developed with the help of the Trailblazer Community.

If you need expert guidance to roll out Salesforce DevOps, monitoring, or AI-assisted documentation at your organization, get in touch with Cloudity - our multi-cloud business and technical experts can help.

Contributions are welcome! Open an issue, suggest a feature, or send a pull request - see the contributors guide.

Name		Name	Last commit message	Last commit date
.claude		.claude
.github		.github
.vscode		.vscode
docs		docs
resources		resources
scripts		scripts
src		src
test/fixtures		test/fixtures
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitleaks.toml		.gitleaks.toml
.grype.yaml		.grype.yaml
.jscpd.json		.jscpd.json
.lycheeignore		.lycheeignore
.mega-linter.yml		.mega-linter.yml
.prettierignore		.prettierignore
.trivyignore		.trivyignore
.vscodeignore		.vscodeignore
.yarnrc		.yarnrc
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
dev.sh		dev.sh
eslint.config.mjs		eslint.config.mjs
lwc.config.json		lwc.config.json
osv-scanner.toml		osv-scanner.toml
package.json		package.json
renovate.json		renovate.json
tsconfig.json		tsconfig.json
webpack.common.js		webpack.common.js
webpack.dev.js		webpack.dev.js
webpack.prod.js		webpack.prod.js
yarn.lock		yarn.lock

Latest commit

History

Folders and files

Repository files navigation