Skip to content

simply-cicd

@simplysf/simply-cicd is an oclif plugin for the Salesforce CLI that provides the building blocks for a Salesforce CI/CD pipeline: creating and tearing down scratch orgs, creating and validating 2GP package versions, running multi-stage deployments, and posting pipeline notifications to Microsoft Teams (with issue-tracker linking).

It’s a proper sf plugin under the sf simply cicd topic, installable via sf plugins install like any other Salesforce CLI plugin, with full --help output and JSON support on every command.

Terminal window
sf plugins install @simplysf/simply-cicd
  • New to the plugin? Read Project vs. Happy Soup first — nearly everything else assumes you know which of the two deployment styles you’re using.
  • Wiring up a pipeline? Deploy pipeline stages explains how the stage commands (validate, pre-destructive, deploy-unpackaged/install-packaged, post-destructive, post-deploy) fit together, and the GitLab CI pipeline guide walks through a working .gitlab-ci.yml.
  • Just need a flag reference? See Command Reference for the full, auto-generated --help output of every command, grouped by topic.

Every command that talks to source control goes through a small VcsProvider abstraction (see VCS providers). GitLab and GitHub are both implemented; --vcs-provider selects between them and defaults to gitlab. Most examples on this site are written GitLab-first, since that’s the more common setup for these pipelines, but the flags and concepts apply to either platform.