# Sfdx Hardis Integration

> Adopt sfdx-hardis for org monitoring, CI pipelines, and release automation. NOT for writing plugins to sfdx-hardis itself.

- Skill: `banibratachatterjee/sfdx-hardis-integration` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add banibratachatterjee/sfdx-hardis-integration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/banibratachatterjee/sfdx-hardis-integration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: BanibrataChatterjee (https://skillmd.com/u/banibratachatterjee)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/banibratachatterjee/sfdx-hardis-integration

---


# sfdx-hardis Integration

sfdx-hardis is an open-source sfdx plugin that wraps org monitoring, deploy validation, and simpler CLI ergonomics. It includes prebuilt GitHub Actions / GitLab CI templates, a daily monitoring job that diffs metadata, and a 'smart deploy' flow.

## When to Use

Teams without Copado / Gearset budget who want a battle-tested open-source stack. Not for teams already deeply invested in DevOps Center.

Typical trigger phrases that should route to this skill: `sfdx hardis setup`, `salesforce monitoring open source`, `cicd for salesforce free`, `hardis commands`.

## Recommended Workflow

1. `sf plugins install sfdx-hardis` on CI agents and developer machines.
2. Run `sf hardis:project:configure:auth` to wire JWT credentials per environment.
3. Adopt the provided CI template (GitHub / GitLab / Azure) — it handles validation, deploy, and rollback hints.
4. Enable `sf hardis:org:monitor:all` as a daily scheduled job to diff metadata and flag drift.
5. Use `sf hardis:work:new` instead of `sf org create scratch` for guided dev workflow.

## Key Considerations

- OSS — no vendor support SLA; community Discord is active.
- Opinionated; layering heavy customization fights the tool.
- Monitoring output is JSON + HTML; wire HTML to GitHub Pages for discoverability.
- Upgrades can be breaking; pin plugin version in CI.

## Worked Examples (see `references/examples.md`)

- *Daily drift monitor* — Detect manual prod changes
- *Smart deploy* — Reduce deploy failures

## Common Gotchas (see `references/gotchas.md`)

- **Plugin version drift** — CI and local produce different output.
- **Long monitor run** — Daily job exceeds 2h.
- **False-positive drift** — Noise alerts.

## Top LLM Anti-Patterns (full list in `references/llm-anti-patterns.md`)

- Running hardis without pinning version
- Ignoring monitor alerts
- Forking hardis to add custom logic (contribute upstream instead)

## Official Sources Used

- Salesforce DX Developer Guide — https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/
- Unlocked Packaging — https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_dev2gp.htm
- SF CLI — https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/
- DevOps Center — https://help.salesforce.com/s/articleView?id=sf.devops_center_overview.htm
- Scratch Org Snapshots — https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_scratch_orgs_snapshots.htm
- sfdx-hardis — https://sfdx-hardis.cloudity.com/