npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

@kitalive/sfdx-plugin

v0.8.0

Published

Kitalive SFDX plugin

Downloads

39

Readme

@kitalive/sfdx-plugin

Version License

Install

sf plugins install @kitalive/sfdx-plugin

Usage

$ npm install -g @kitalive/sfdx-plugin
$ sf COMMAND
running command...
$ sf (--version)
@kitalive/sfdx-plugin/1.0.0-rc.3 darwin-arm64 node-v22.17.1
$ sf --help [COMMAND]
USAGE
  $ sf COMMAND
...

Commands

sf kit data bulk delete

Bulk delete records by SOQL select query.

USAGE
  $ sf kit data bulk delete -q <value> -o <value> [--json] [--flags-dir <value>] [--hard] [--concurrency-mode
    Serial|Parallel] [-s <value>] [-w <value>] [--api-version <value>]

FLAGS
  -o, --target-org=<value>         (required) Username or alias of the target org. Not required if the `target-org`
                                   configuration variable is already set.
  -q, --query=<value>              (required) SOQL query to delete
  -s, --batch-size=<value>         [default: 10000] The batch size of the job
  -w, --wait=<value>               The number of minutes to wait for the command to complete before displaying the
                                   results
      --api-version=<value>        Override the api version used for api requests made by this command
      --concurrency-mode=<option>  [default: Parallel] The concurrency mode (Parallel or Serial) for the job
                                   <options: Serial|Parallel>
      --hard                       Perform a hard delete

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

EXAMPLES
  Delete Opportunity records with CloseDate older than 2 years:

    $ sf kit data bulk delete -q "SELECT Id FROM Opportunity WHERE CloseDate < LAST_N_YEARS:2"

See code: src/commands/kit/data/bulk/delete.ts

sf kit data bulk insert

For information about CSV file formats, see Prepare CSV Files in the Bulk API Developer Guide.

USAGE
  $ sf kit data bulk insert -s <value> -f <value> -o <value> [-r <value>] [-e <value>] [-d <value>] [-q <value>]
    [--skip-lines <value>] [--trim] [-m <value>] [-c <value>] [--set-null] [--convert-only] [--concurrency-mode
    Serial|Parallel] [--assignment-rule-id <value>] [--batch-size <value>] [-w <value>] [--api-version <value>]

FLAGS
  -c, --converter=<value>           The path of the script to convert CSV rows
  -d, --delimiter=<value>           [default: ,] The input CSV file delimiter
  -e, --encoding=<value>            [default: utf8] The input CSV file encoding
  -f, --csv-file=<value>            (required) The CSV file path that defines the records to insert
  -m, --mapping=<value>             The path of the JSON file that defines CSV column mappings
  -o, --target-org=<value>          (required) Username or alias of the target org. Not required if the `target-org`
                                    configuration variable is already set.
  -q, --quote=<value>               [default: "] The input CSV file quote character
  -r, --result-file=<value>         The CSV file path for writing the insert results
  -s, --sobject=<value>             (required) The SObject name to insert
  -w, --wait=<value>                The number of minutes to wait for the command to complete before displaying the
                                    results
      --api-version=<value>         Override the api version used for api requests made by this command
      --assignment-rule-id=<value>  The ID of a specific assignment rule to run for a case or a lead
      --batch-size=<value>          [default: 10000] The batch size of the job
      --concurrency-mode=<option>   [default: Parallel] The concurrency mode (Parallel or Serial) for the job
                                    <options: Serial|Parallel>
      --convert-only                Output converted.csv file and skip insert for debugging
      --set-null                    Set blank values as null values during insert operations (default: empty field
                                    values are ignored)
      --skip-lines=<value>          The number of lines to skip
      --trim                        Trim all white space from columns

DESCRIPTION
  For information about CSV file formats, see [Prepare CSV
  Files](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_csv_preparing.htm) in
  the Bulk API Developer Guide.

EXAMPLES
  Insert Account records with mapping.json:

    $ sf kit data bulk insert -o Account -f ./path/to/Account.csv -m ./path/to/mapping.json

  %s MyObject__c records with convert.js:

    $ sf kit data bulk insert -o MyObject__c -f ./path/to/MyObject__c.csv -c ./path/to/convert.js -w 10

See code: src/commands/kit/data/bulk/insert.ts

sf kit data bulk query

Bulk query records.

USAGE
  $ sf kit data bulk query -q <value> -o <value> [--json] [--flags-dir <value>] [-f <value>] [--all] [-w <value>]
    [--api-version <value>]

FLAGS
  -f, --csv-file=<value>     [default: standard output] Output csv file
  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                             configuration variable is already set.
  -q, --query=<value>        (required) SOQL query to export
  -w, --wait=<value>         [default: 5] The number of minutes to wait for the command to complete before displaying
                             the results
      --all                  include deleted or archived records
      --api-version=<value>  Override the api version used for api requests made by this command

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

EXAMPLES
  Query Account records and save to specified path:

    $ sf kit data bulk query -q "SELECT Id, Name FROM Account" -f ./path/to/Account.csv

See code: src/commands/kit/data/bulk/query.ts

sf kit data bulk update

For information about CSV file formats, see Prepare CSV Files in the Bulk API Developer Guide.

USAGE
  $ sf kit data bulk update -s <value> -f <value> -o <value> [-r <value>] [-e <value>] [-d <value>] [-q <value>]
    [--skip-lines <value>] [--trim] [-m <value>] [-c <value>] [--set-null] [--convert-only] [--concurrency-mode
    Serial|Parallel] [--assignment-rule-id <value>] [--batch-size <value>] [-w <value>] [--api-version <value>]

FLAGS
  -c, --converter=<value>           The path of the script to convert CSV rows
  -d, --delimiter=<value>           [default: ,] The input CSV file delimiter
  -e, --encoding=<value>            [default: utf8] The input CSV file encoding
  -f, --csv-file=<value>            (required) The CSV file path that defines the records to update
  -m, --mapping=<value>             The path of the JSON file that defines CSV column mappings
  -o, --target-org=<value>          (required) Username or alias of the target org. Not required if the `target-org`
                                    configuration variable is already set.
  -q, --quote=<value>               [default: "] The input CSV file quote character
  -r, --result-file=<value>         The CSV file path for writing the update results
  -s, --sobject=<value>             (required) The SObject name to update
  -w, --wait=<value>                The number of minutes to wait for the command to complete before displaying the
                                    results
      --api-version=<value>         Override the api version used for api requests made by this command
      --assignment-rule-id=<value>  The ID of a specific assignment rule to run for a case or a lead
      --batch-size=<value>          [default: 10000] The batch size of the job
      --concurrency-mode=<option>   [default: Parallel] The concurrency mode (Parallel or Serial) for the job
                                    <options: Serial|Parallel>
      --convert-only                Output converted.csv file and skip update for debugging
      --set-null                    Set blank values as null values during update operations (default: empty field
                                    values are ignored)
      --skip-lines=<value>          The number of lines to skip
      --trim                        Trim all white space from columns

DESCRIPTION
  For information about CSV file formats, see [Prepare CSV
  Files](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_csv_preparing.htm) in
  the Bulk API Developer Guide.

EXAMPLES
  Update Account records with mapping.json:

    $ sf kit data bulk update -o Account -f ./path/to/Account.csv -m ./path/to/mapping.json

  %s MyObject__c records with convert.js:

    $ sf kit data bulk update -o MyObject__c -f ./path/to/MyObject__c.csv -c ./path/to/convert.js -w 10

See code: src/commands/kit/data/bulk/update.ts

sf kit data bulk upsert

For information about CSV file formats, see Prepare CSV Files in the Bulk API Developer Guide.

USAGE
  $ sf kit data bulk upsert -s <value> -f <value> -o <value> -i <value> [-r <value>] [-e <value>] [-d <value>] [-q
    <value>] [--skip-lines <value>] [--trim] [-m <value>] [-c <value>] [--set-null] [--convert-only] [--concurrency-mode
    Serial|Parallel] [--assignment-rule-id <value>] [--batch-size <value>] [-w <value>] [--api-version <value>]

FLAGS
  -c, --converter=<value>           The path of the script to convert CSV rows
  -d, --delimiter=<value>           [default: ,] The input CSV file delimiter
  -e, --encoding=<value>            [default: utf8] The input CSV file encoding
  -f, --csv-file=<value>            (required) The CSV file path that defines the records to upsert
  -i, --external-id=<value>         (required) [default: Id] The column name of the external ID
  -m, --mapping=<value>             The path of the JSON file that defines CSV column mappings
  -o, --target-org=<value>          (required) Username or alias of the target org. Not required if the `target-org`
                                    configuration variable is already set.
  -q, --quote=<value>               [default: "] The input CSV file quote character
  -r, --result-file=<value>         The CSV file path for writing the upsert results
  -s, --sobject=<value>             (required) The SObject name to upsert
  -w, --wait=<value>                The number of minutes to wait for the command to complete before displaying the
                                    results
      --api-version=<value>         Override the api version used for api requests made by this command
      --assignment-rule-id=<value>  The ID of a specific assignment rule to run for a case or a lead
      --batch-size=<value>          [default: 10000] The batch size of the job
      --concurrency-mode=<option>   [default: Parallel] The concurrency mode (Parallel or Serial) for the job
                                    <options: Serial|Parallel>
      --convert-only                Output converted.csv file and skip upsert for debugging
      --set-null                    Set blank values as null values during upsert operations (default: empty field
                                    values are ignored)
      --skip-lines=<value>          The number of lines to skip
      --trim                        Trim all white space from columns

DESCRIPTION
  For information about CSV file formats, see [Prepare CSV
  Files](https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_csv_preparing.htm) in
  the Bulk API Developer Guide.

EXAMPLES
  Upsert Account records with mapping.json:

    $ sf kit data bulk upsert -o Account -f ./path/to/Account.csv -m ./path/to/mapping.json

  Upsert MyObject__c with convert.js and external ID

    $ sf kit data bulk upsert -o MyObject__c -f ./path/to/MyObject__c.csv -c ./path/to/convert.js -i MyExternalId__c \
      -w 10

See code: src/commands/kit/data/bulk/upsert.ts

sf kit data csv convert

Convert CSV data using column mapping file or Node.js script.

USAGE
  $ sf kit data csv convert [--json] [--flags-dir <value>] [-i <value>] [-f <value>] [-e <value>] [-d <value>] [-q
    <value>] [--skip-lines <value>] [--trim] [-m <value>] [-c <value>] [-o <value>] [--api-version <value>]

FLAGS
  -c, --converter=<value>    The path of the script to convert CSV rows
  -d, --delimiter=<value>    [default: ,] The input CSV file delimiter
  -e, --encoding=<value>     [default: utf8] The input CSV file encoding
  -f, --output=<value>       [default: standard output] The path of the output CSV file
  -i, --input=<value>        [default: standard input] The path of the input CSV file
  -m, --mapping=<value>      The path of the JSON file that defines CSV column mappings
  -o, --target-org=<value>   Username or alias of the target org.
  -q, --quote=<value>        [default: "] The input CSV file quote character
      --api-version=<value>  Override the api version used for api requests made by this command
      --skip-lines=<value>   The number of lines to skip
      --trim                 Trim all white space from columns

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

EXAMPLES
  Convert csv file using mapping file and output to standard output:

    $ sf kit data csv convert -i ./path/to/input.csv -m ./path/to/mapping.json

  Convert csv file using script and output to specified path:

    $ sf kit data csv convert -i ./path/to/input.csv -f ./path/to/output.csv -c ./path/to/convert.js

See code: src/commands/kit/data/csv/convert.ts

sf kit graphql editor

Open the GraphQL Editor in a browser

USAGE
  $ sf kit graphql editor -o <value> [--json] [--flags-dir <value>] [-b chrome|firefox|edge] [-p <value>] [--api-version
    <value>]

FLAGS
  -b, --browser=<option>     browser to use
                             <options: chrome|firefox|edge>
  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                             configuration variable is already set.
  -p, --port=<value>         [default: 3000] local server port number
      --api-version=<value>  Override the api version used for api requests made by this command

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

DESCRIPTION
  Open the GraphQL Editor in a browser

  It can interact with Salesforce GraphQL API using [GraphiQL](https://github.com/graphql/graphiql)

EXAMPLES
  $ sf kit graphql editor

  $ sf kit graphql editor --port 8080

See code: src/commands/kit/graphql/editor.ts

sf kit layout assignments deploy

Deploy page layout assignments from JSON file.

USAGE
  $ sf kit layout assignments deploy -f <value> -o <value> [--json] [--flags-dir <value>] [--api-version <value>]

FLAGS
  -f, --file=<value>         (required) [default: config/layout-assignments.json] Input file path of page layout
                             assignment settings.
  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                             configuration variable is already set.
      --api-version=<value>  Override the api version used for api requests made by this command

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

EXAMPLES
  Deploy from the default file path to the default org:

    $ sf kit layout assignments deploy

  Deploy from the specified file to the default org:

    $ sf kit layout assignments deploy -f config/layout-assignments.scratch.json

  Deploy from the specified file to the specified org:

    $ sf kit layout assignments deploy -o [email protected] -f config/layout-assignments.sandbox.json

See code: src/commands/kit/layout/assignments/deploy.ts

sf kit layout assignments retrieve

Retrieve page layout assignments and save to JSON file.

USAGE
  $ sf kit layout assignments retrieve -f <value> -o <value> [--json] [--flags-dir <value>] [-p <value>...] [-s <value>...] [--merge]
    [--api-version <value>]

FLAGS
  -f, --file=<value>         (required) [default: config/layout-assignments.json] Output file path of page layout
                             assignment settings.
  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                             configuration variable is already set.
  -p, --profile=<value>...   [default: all profiles] Profile names to retrieve
  -s, --sobject=<value>...   [default: sobjects which have multiple layouts] SObject names to retrieve
      --api-version=<value>  Override the api version used for api requests made by this command
      --merge                Merge retrieved configurations with existing file.

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

EXAMPLES
  Retrieve page layout assignments from the default org and save to the default path:

    $ sf kit layout assignments retrieve

  Retrieve Admin profile's Account and Contact page layout assignments and save to the specified path:

    $ sf kit layout assignments retrieve -p Admin -s Account -s Contact -f config/layout-assignments.scratch.json

  Retrieve page layout assignments from the specified org and save to the specified path:

    $ sf kit layout assignments retrieve -o [email protected] -f config/layout-assignments.sandbox.json

See code: src/commands/kit/layout/assignments/retrieve.ts

sf kit metadata dependencies

Analyze metadata dependencies

USAGE
  $ sf kit metadata dependencies -o <value> [--json] [--flags-dir <value>] [-b chrome|firefox|edge] [-p <value>] [--api-version
    <value>]

FLAGS
  -b, --browser=<option>     browser to use
                             <options: chrome|firefox|edge>
  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                             configuration variable is already set.
  -p, --port=<value>         [default: 3000] local server port number
      --api-version=<value>  Override the api version used for api requests made by this command

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

EXAMPLES
  $ sf kit metadata dependencies

See code: src/commands/kit/metadata/dependencies.ts

sf kit object fields describe

Describe sobject fields information.

USAGE
  $ sf kit object fields describe -s <value> -o <value> [--json] [--flags-dir <value>] [-f <value>] [--api-version
  <value>]

FLAGS
  -f, --file=<value>         Output csv file path
  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                             configuration variable is already set.
  -s, --sobject=<value>      (required) SObject name to describe
      --api-version=<value>  Override the api version used for api requests made by this command

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

EXAMPLES
  Describe Account fields of the default org and save to csv file:

    $ sf kit object fields describe -s Account -f path/to/account_fields.csv

  Output CustomObject__c fields of the specified org as JSON format:

    $ sf kit object fields describe -o [email protected] -s CustomObject__c --json

See code: src/commands/kit/object/fields/describe.ts

sf kit object fields setup

Upsert and delete sobject fields from a CSV file.

USAGE
  $ sf kit object fields setup -s <value> -f <value> -o <value> [--json] [--flags-dir <value>] [--delete] [--force]
    [--api-version <value>]

FLAGS
  -f, --file=<value>         (required) Input csv file path
  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
                             configuration variable is already set.
  -s, --sobject=<value>      (required) SObject name to setup
      --api-version=<value>  Override the api version used for api requests made by this command
      --delete               Delete fields that are not in the csv file
      --force                Do not confirm when deleting

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

EXAMPLES
  Upsert Account fields to the default org:

    $ sf kit object fields setup -s Account -f path/to/account_fields.csv

  Upsert and delete CustomObject__c fields to the specified org:

    $ sf kit object fields setup -o [email protected] -s CustomObject__c -f path/to/custom_object_fields.csv --delete

See code: src/commands/kit/object/fields/setup.ts

sf kit script

Execute Node.js scripts in SfCommand context.

USAGE
  $ sf kit script [--json] [--flags-dir <value>] [-f <value>] [-o <value>] [--api-version <value>]

FLAGS
  -f, --file=<value>         The path of the Node.js script file to execute.
  -o, --target-org=<value>   Username or alias of the target org.
      --api-version=<value>  Override the api version used for api requests made by this command

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

DESCRIPTION
  Execute Node.js scripts in SfCommand context.

  Available variables in Node.js scripts

  - argv: Parsed command line arguments after the file option
  - conn: jsforce Connection
  - context: SfCommand

ALIASES
  $ sf kit script

EXAMPLES
  Execute from js file:

    $ sf kit script -f ./path/to/script.js

  Execute from js file with arguments:

    $ sf kit script -f ./path/to/script.js -- --opt1 val1 --opt2 val2 arg1 arg2

  Execute in REPL mode:

    $ sf kit script -o target-org

  query a account from org in REPL
  > await conn.query('SELECT Id, Name FROM Account LIMIT 1')

sf kit script execute

Execute Node.js scripts in SfCommand context.

USAGE
  $ sf kit script execute [--json] [--flags-dir <value>] [-f <value>] [-o <value>] [--api-version <value>]

FLAGS
  -f, --file=<value>         The path of the Node.js script file to execute.
  -o, --target-org=<value>   Username or alias of the target org.
      --api-version=<value>  Override the api version used for api requests made by this command

GLOBAL FLAGS
  --flags-dir=<value>  Import flag values from a directory.
  --json               Format output as json.

DESCRIPTION
  Execute Node.js scripts in SfCommand context.

  Available variables in Node.js scripts

  - argv: Parsed command line arguments after the file option
  - conn: jsforce Connection
  - context: SfCommand

ALIASES
  $ sf kit script

EXAMPLES
  Execute from js file:

    $ sf kit script execute -f ./path/to/script.js

  Execute from js file with arguments:

    $ sf kit script execute -f ./path/to/script.js -- --opt1 val1 --opt2 val2 arg1 arg2

  Execute in REPL mode:

    $ sf kit script execute -o target-org

  query a account from org in REPL
  > await conn.query('SELECT Id, Name FROM Account LIMIT 1')

See code: src/commands/kit/script/execute.ts