1.4.2 • Public • Published


NPM version NPM version

sfdx is a node module used to interact with Salesforce DX commands, hopefully in a more intuitive way than with the DX CLI itself. sfdx is meant to take some of the nuances of using Salesforce DX and make common operations easier.

If you find this useful, please consider donating to my Patreon to help me develop!

Help / Documentation


Make sure you have the Salesforce DX CLI installed first! This module will let you know if you don't, but it will leave it up to you to actually install it.

npm i sfdx --save


(Sample project here.)

Here is a function that one might use to spin up an org and push code into it:

const sfdx = require('sfdx')
// options - all options to use for the relevant commands
//   (see sfdx config documentation)
function spinup(options) {
  // Create a new scratch org
  // Push local code into the newly-created scratch org
  // Open the newly-created scratch org in a browser window

As another example, here is a function that pulls code from a scratch org, converts the local Salesforce DX code into Metadata API format, and deploys the converted code into a production (i.e. non-scratch) org.

const sfdx = require('sfdx')
// options - all options to use for the relevant commands
//   (see sfdx config documentation)
function toproduction(options) {
  // Pull code from the scratch org
  // Convert local Salesforce DX code into Metadata API format
  // Deploy the formatted code into a non-scratch org
  //   'deployto' specifies to deploy to the org named 'MySandbox'
    deployto: 'MySandbox'

To import all commands to be used in a CLI

All of the commands have a relevant terminal command (including shortcuts!), thanks to yargs. To import all of them, simply use the .yargs property of each to create the relevant command.

For example, to import all of the commands, do the following (ensure you have yargs installed):

#!/usr/bin/env node
const sfdx = require('sfdx')
const yargs = require('yargs')
// Import all commands
for (let command of Object.keys(sfdx)) {
// Initialize yargs commands

Then, if you save that file as "cli.js" and you add something like the following to your package.json and then run "npm link", the command "dx l" will list all connected orgs (for example)!

    "dx": "cli.js"

** For help with the terminal commands, which includes seeing a command's shortcuts, use --help (or -h) on any command. To see help for ALL commands, use --help (or -h) on the root command (for example dx -h)!

Further Help / Documentation

Package Sidebar


npm i sfdx

Weekly Downloads






Unpacked Size

57.2 kB

Total Files


Last publish


  • zandermax