sfdx-hardis
v6.25.0
Swiss-army-knife Toolbox for Salesforce. Allows you to define a complete CD/CD Pipeline. Orchestrate base commands and assist users with interactive wizards
0/weekUpdated todayAGPL-3.0Unpacked: 6.6 MB
Published by NicolasVuillamy @nvuillam
npm install sfdx-hardis
_Presented at_ _Dreamforce 23_ _and _Dreamforce 24!__
Sfdx-hardis is a CLI and visual productivity tools suite for Salesforce, by Cloudity & friends, natively compliant with most Git platforms, messaging tools, ticketing systems and AI providers (including Agentforce).
It is free and Open-Source, and will allow you to simply:
- Deliver your projects with State of the art Salesforce DevOps
- Backup Metadatas and Monitor your Salesforce orgs
- Generate your Project Documentation with AI
!Salesforce AI Generated Documentation
- Enjoy many commands that will save your minutes, hours or even days in your daily Admin or Developer work.
If you need guidance about how to leverage sfdx-hardis to bring more value to your business, Cloudity's international multi-cloud teams of business experts and technical experts can help: contact us !
_See online documentation for a better navigation_
___
sfdx-hardis commands and configuration are best used with an UI in SFDX Hardis Visual Studio Code Extension
___
_Featured on SalesforceBen_
_See Dreamforce presentation_
Installation
$3
You can install Visual Studio Code, then VSCode Extension VsCode SFDX Hardis
Once installed, click on !Hardis Group button in VsCode left bar, click on Install dependencies and follow the additional installation instructions :)
When you are all green, you are all good 😊
_You can also watch the video tutorial below_
___
$3
#### Pre-requisites
- Install Node.js (recommended version)
- Install Salesforce DX by running npm install @salesforce/cli --global command line
#### Plugin installation
``sh-session`
sf plugins install sfdx-hardis
For advanced use, please also install dependencies
`sh-session`
sf plugins install @salesforce/plugin-packaging
sf plugins install sfdx-git-delta
sf plugins install sfdmu
If you are using CI/CD scripts, use echo y | sf plugins install ... to bypass prompt.
___
$3
You can use sfdx-hardis docker images to run in CI.
> All our Docker images are checked for security issues with MegaLinter by OX Security
- Linux Alpine based images (works on Gitlab)
- Docker Hub
- hardisgroupcom/sfdx-hardis:latest (with latest @salesforce/cli version)
- hardisgroupcom/sfdx-hardis:latest-sfdx-recommended (with recommended @salesforce/cli version, in case the latest version of @salesforce/cli is buggy)
- GitHub Packages (ghcr.io)
- ghcr.io/hardisgroupcom/sfdx-hardis:latest (with latest @salesforce/cli version)
- ghcr.io/hardisgroupcom/sfdx-hardis:latest-sfdx-recommended (with recommended @salesforce/cli version, in case the latest version of @salesforce/cli is buggy)
_See Dockerfile_
- Linux Ubuntu based images (works on GitHub, Azure & Bitbucket)
- hardisgroupcom/sfdx-hardis-ubuntu:latest (with latest @salesforce/cli version)
- hardisgroupcom/sfdx-hardis-ubuntu:latest-sfdx-recommended (with recommended @salesforce/cli version, in case the latest version of @salesforce/cli is buggy)
- GitHub Packages (ghcr.io)
- ghcr.io/hardisgroupcom/sfdx-hardis-ubuntu:latest (with latest @salesforce/cli version)
- ghcr.io/hardisgroupcom/sfdx-hardis-ubuntu:latest-sfdx-recommended (with recommended @salesforce/cli version, in case the latest version of @salesforce/cli is buggy)
_See Dockerfile-ubuntu_
Usage
`sh-session`
sf hardis:
Events
$3
Refresh your full sandboxes without needing to reconfigure everything — with Mehdi Abdennasser
Paris, France — 02/12/2025
$3
Why you don't need DevOps vendors tools
London, UK — 20/11/2025
$3
Salesforce Org Documentation with Open-Source and Agentforce, by Taha Basri
$3
Summer of Docs – Auto-Document Your Salesforce Org Like a Pro, by Mariia Pyvovarchuk (Aspect) and Roman Hentschke
$3
Auto-generate your SF project Documentation site with open-source and Agentforce
$3
Auto-generate your SF project Documentation site with open-source and Agentforce, with Mariia Pyvovarchuk
$3
Techs for Admins: Afterwork Salesforce Inspector Reloaded & sfdx-hardis, with Thomas Prouvot
$3
Save the Day by Monitoring Your Org with Open-Source Tools, with Olga Shirikova
$3
Automate the Monitoring of your Salesforce orgs with open-source tools only!, with Yosra Saidani
$3
Easy and complete Salesforce CI/CD with open-source only!, with Wojciech Suwiński
$3
Automate the Monitoring of your Salesforce orgs with open-source tools only!, with Maxime Guenego
$3
Easy Salesforce CI/CD with open-source and clicks only thanks to sfdx-hardis!, with Jean-Pierre Rizzi
$3
An easy and complete Salesforce CI/CD release management with open-source only !, with Angélique Picoreau
Articles & Videos
$3
Here are some articles about sfdx-hardis
- English
- French
- Versions d'API Salesforce décommissionnées: Que faire ?
- Exporter en masse les fichiers d’une org Salesforce
- Suspendre l’accès aux utilisateurs lors d’une mise en production Salesforce
$3
#### Dreamforce Sessions
- Dreamforce 2024 - Save the Day by Monitoring Your Org with Open-Source Tools (with Olga Shirikova)
{target=blank}
- Dreamforce 2023 - Easy Salesforce CI/CD with open-source and clicks only thanks to sfdx-hardis! (with Jean-Pierre Rizzi)
{target=blank}
#### Community Events
- Wir Sind Ohana 2024 - Automate the Monitoring of your Salesforce orgs with open-source tools only! (with Yosra Saidani)
{target=blank}
$3
- SalesforceBen Deep Dives with Peter Chittum, 2025: _Simplify Salesforce Deployment with SFDX Hardis_
- Apex Hours 2025 - Org monitoring with Grafana + AI generated doc
{target=blank}
- Salesforce Way Podcast #102 - Sfdx-hardis with Nicolas Vuillamy
{target=blank}
- Salesforce Developers Podcast Episode 182: SFDX-Hardis with Nicolas Vuillamy
{target=blank}
$3
#### Features Overview
- sfdx-hardis 2025 new features overview
{target=blank}
- SFDX-HARDIS – A demo with Nicolas Vuillamy from Cloudity
{target=blank}
#### Installation & Setup
- Complete installation tutorial for sfdx-hardis - 📖 Documentation
{target=blank}
#### CI/CD Workflows
- Complete CI/CD workflow for Salesforce projects - 📖 Documentation
{target=blank}
- How to start a new User Story in sandbox - 📖 Documentation
{target=blank}
- How to commit updates and create merge requests - 📖 Documentation
{target=blank}
- How to resolve git merge conflicts in Visual Studio Code - 📖 Documentation
{target=blank}
- How to install packages in your org - 📖 Documentation
{target=blank}
- Configure CI server authentication to Salesforce orgs - 📖 Documentation
{target=blank}
#### Monitoring
- How to configure monitoring for your Salesforce org - 📖 Documentation
{target=blank}
#### Integrations
- Configure Slack integration for deployment notifications - 📖 Documentation
{target=blank}
- How to create a Personal Access Token in GitLab - 📖 Documentation
{target=blank}
#### Documentation
- How to generate AI-enhanced Salesforce project documentation - 📖 Documentation
{target=blank}
- Host your documentation on Cloudflare free tier - 📖 Documentation
{target=blank}
Contributing
Everyone is welcome to contribute to sfdx-hardis (even juniors: we'll assist you !)
$3
- Install Node.js (recommended version)
- Install typescript by running npm install typescript --global
- Install yarn by running
- Install Salesforce DX by running command lineyarn
- Fork
- At the root of the repository:
- Run to install dependenciessf plugins link
- Run to link the local sfdx-hardis to SFDX CLItsc --watch
- Run to transpile typescript into js everytime you update a TS fileNODE_OPTIONS=--inspect-brk sf hardis:somecommand --someparameter somevalue
- Debug commands using (you can also debug commands using VsCode Sfdx-Hardis setting)
Note: To test a feature from CI, you can add the following code in your workflow before running sfdx-hardis commands:
`sh
REPO_URL="https://github.com/hardisgroupcom/sfdx-hardis.git" # or your forked repo URL
GIT_BRANCH="fixes/my-git-branch" # or the branch you want to test
TEMP_DIR=$(mktemp -d)
git clone "$REPO_URL" "$TEMP_DIR"
cd "$TEMP_DIR"
git checkout "$GIT_BRANCH"
yarn
npm install typescript --global
tsc
sf plugins link
cd -
`
$3
- Install Node.js (recommended version)
- Install typescript by running npm install typescript --global
- Install yarn by running
- Install Visual Studio Code Insiders (download here)
- Fork
- At the root of the repository:
- Run to install dependenciesvscode-sfdx-hardis
- To test your code in the VsCode Extension:
- Open the folder in VsCode InsidersF5` to open a new VsCode window with the extension loaded (or menu Run -> Start Debugging)
- Press
- In the new window, open a Salesforce DX project
- Run commands from the command palette (Ctrl+Shift+P) or use the buttons in the panel or webviews
Dependencies
sfdx-hardis partially relies on the following SFDX Open-Source packages
- SFDX Git Delta
- Salesforce Data Move Utility
Contributors
$3
sfdx-hardis is primarily led by Nicolas Vuillamy & Cloudity, but has many external contributors that we cant thank enough !
$3
$3
- Roman Hentschke, for building the BitBucket CI/CD integration
- Leo Jokinen, for building the GitHub CI/CD integration
- Mariia Pyvovarchuk, for her work about generating automations documentation
- Matheus Delazeri, for the PDF output of documentation
- Taha Basri, for his work about generating documentation of LWC
- Anush Poudel, for integrating sfdx-hardis with multiple LLMs using langchainJs
- Sebastien Colladon, for providing sfdx-git-delta which is highly used within sfdx-hardis
- Stepan Stepanov, for implementing the deployment mode _delta with dependencies_
- Shamina Mossodeean, for automating SF decomposed metadata
- Michael Havrilla, for the integration with Vector.dev allowing to provide monitoring logs to external systems like DataDog
- Teoman Sertcelik, for allowing to configure authentication using External Client App
Commands
Read Online Documentation to see everything you can do with SFDX Hardis :)