{"id":33589336,"url":"https://github.com/salesforcecli/plugin-signups","last_synced_at":"2026-05-02T13:03:32.417Z","repository":{"id":37998143,"uuid":"465362549","full_name":"salesforcecli/plugin-signups","owner":"salesforcecli","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-25T11:56:12.000Z","size":7073,"stargazers_count":1,"open_issues_count":3,"forks_count":7,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-04-25T13:31:04.526Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/salesforcecli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-03-02T15:29:52.000Z","updated_at":"2026-04-25T11:55:57.000Z","dependencies_parsed_at":"2022-07-12T17:04:25.596Z","dependency_job_id":"a49ea6f8-336c-4a19-982c-45c037712816","html_url":"https://github.com/salesforcecli/plugin-signups","commit_stats":{"total_commits":290,"total_committers":15,"mean_commits":"19.333333333333332","dds":0.5310344827586206,"last_synced_commit":"55efe27f04764ce0b41492399c1c360cd2090de6"},"previous_names":[],"tags_count":215,"template":false,"template_full_name":"salesforcecli/plugin-template","purl":"pkg:github/salesforcecli/plugin-signups","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-signups","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-signups/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-signups/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-signups/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/salesforcecli","download_url":"https://codeload.github.com/salesforcecli/plugin-signups/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-signups/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32534973,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-11-29T14:04:27.739Z","updated_at":"2026-05-02T13:03:32.412Z","avatar_url":"https://github.com/salesforcecli.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# plugin-signups\n\n[![NPM](https://img.shields.io/npm/v/@salesforce/plugin-signups.svg?label=@salesforce/plugin-signups)](https://www.npmjs.com/package/@salesforce/plugin-signups) [![Downloads/week](https://img.shields.io/npm/dw/@salesforce/plugin-signups.svg)](https://npmjs.org/package/@salesforce/plugin-signups) [![License](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](https://opensource.org/license/apache-2-0)\n\n## Learn about the plugin-signups\n\nSalesforce CLI plugins are based on the [oclif plugin framework](https://oclif.io/docs/introduction). Read the [plugin developer guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_plugins.meta/sfdx_cli_plugins/cli_plugins_architecture_sf_cli.htm) to learn about Salesforce CLI plugin development.\n\nThis repository contains a lot of additional scripts and tools to help with general Salesforce node development and enforce coding standards. You should familiarize yourself with some of the [node developer packages](https://github.com/forcedotcom/sfdx-dev-packages/) used by Salesforce. There is also a default circleci config using the [release management orb](https://github.com/forcedotcom/npm-release-management-orb) standards.\n\nAdditionally, there are some additional tests that the Salesforce CLI will enforce if this plugin is ever bundled with the CLI. These test are included by default under the `posttest` script and it is recommended to keep these tests active in your plugin, regardless if you plan to have it bundled.\n\n# Everything past here is only a suggestion as to what should be in your specific plugin's description\n\nThis plugin is bundled with the [Salesforce CLI](https://developer.salesforce.com/tools/sfdxcli). For more information on the CLI, read the [getting started guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm).\n\nWe always recommend using the latest version of these commands bundled with the CLI, however, you can install a specific version or tag if needed.\n\n## Install\n\n```bash\nsfdx plugins:install signups@x.y.z\n```\n\n## Issues\n\nPlease report any issues at https://github.com/forcedotcom/cli/issues\n\n## Contributing\n\n1. Please read our [Code of Conduct](CODE_OF_CONDUCT.md)\n2. Create a new issue before starting your project so that we can keep track of\n   what you are trying to add/fix. That way, we can also offer suggestions or\n   let you know if there is already an effort in progress.\n3. Fork this repository.\n4. [Build the plugin locally](#build)\n5. Create a _topic_ branch in your fork. Note, this step is recommended but technically not required if contributing using a fork.\n6. Edit the code in your fork.\n7. Write appropriate tests for your changes. Try to achieve at least 95% code coverage on any new code. No pull request will be accepted without unit tests.\n8. Sign CLA (see [CLA](#cla) below).\n9. Send us a pull request when you are done. We'll review your code, suggest any needed changes, and merge it in.\n\n### CLA\n\nExternal contributors will be required to sign a Contributor's License\nAgreement. You can do so by going to https://cla.salesforce.com/sign-cla.\n\n### Build\n\nTo build the plugin locally, make sure to have yarn installed and run the following commands:\n\n```bash\n# Clone the repository\ngit clone git@github.com:salesforcecli/plugin-signups\n\n# Install the dependencies and compile\nyarn install\nyarn build\n```\n\nTo use your plugin, run using the local `./bin/dev` or `./bin/dev.cmd` file.\n\n```bash\n# Run using local run file.\n./bin/dev force:org:shape\n```\n\nThere should be no differences when running via the Salesforce CLI or using the local run file. However, it can be useful to link the plugin to do some additional testing or run your commands from anywhere on your machine.\n\n```bash\n# Link your plugin to the sfdx cli\nsfdx plugins:link .\n# To verify\nsfdx plugins\n```\n\n## Commands\n\n\u003c!-- commands --\u003e\n\n- [`sf org create shape`](#sf-org-create-shape)\n- [`sf org create snapshot`](#sf-org-create-snapshot)\n- [`sf org delete shape`](#sf-org-delete-shape)\n- [`sf org delete snapshot`](#sf-org-delete-snapshot)\n- [`sf org get snapshot`](#sf-org-get-snapshot)\n- [`sf org list shape`](#sf-org-list-shape)\n- [`sf org list snapshot`](#sf-org-list-snapshot)\n\n## `sf org create shape`\n\nCreate a scratch org configuration (shape) based on the specified source org.\n\n```\nUSAGE\n  $ sf org create shape -o \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [--api-version \u003cvalue\u003e]\n\nFLAGS\n  -o, --target-org=\u003cvalue\u003e   (required) Username or alias of the target org. Not required if the `target-org`\n                             configuration variable is already set.\n      --api-version=\u003cvalue\u003e  Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Create a scratch org configuration (shape) based on the specified source org.\n\n  Scratch org shapes mimic the baseline setup (features, limits, edition, and Metadata API settings) of a source org\n  without the extraneous data and metadata.\n\n  Run \"sf org list shape\" to view the available org shapes and their IDs.\n\n  To create a scratch org from an org shape, include the \"sourceOrg\" property in the scratch org definition file and set\n  it to the org ID of the source org. Then create a scratch org with the \"sf org create scratch\" command.\n\nALIASES\n  $ sf force org shape create\n\nEXAMPLES\n  Create an org shape for the source org with alias SourceOrg:\n\n    $ sf org create shape --target-org SourceOrg\n```\n\n_See code: [src/commands/org/create/shape.ts](https://github.com/salesforcecli/plugin-signups/blob/2.6.67/src/commands/org/create/shape.ts)_\n\n## `sf org create snapshot`\n\nCreate a snapshot of a scratch org.\n\n```\nUSAGE\n  $ sf org create snapshot -v \u003cvalue\u003e -o \u003cvalue\u003e -n \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [--api-version \u003cvalue\u003e] [-d\n    \u003cvalue\u003e]\n\nFLAGS\n  -d, --description=\u003cvalue\u003e     Description of snapshot.\n  -n, --name=\u003cvalue\u003e            (required) Unique name of snapshot.\n  -o, --source-org=\u003cvalue\u003e      (required) ID or locally authenticated username or alias of scratch org to snapshot.\n  -v, --target-dev-hub=\u003cvalue\u003e  (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`\n                                configuration variable is already set.\n      --api-version=\u003cvalue\u003e     Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Create a snapshot of a scratch org.\n\n  A snapshot is a point-in-time copy of a scratch org. The copy is referenced by its unique name in a scratch org\n  definition file.\n\n  Use \"sf org get snapshot\" to get details, including status, about a snapshot creation request.\n\n  To create a scratch org from a snapshot, include the \"snapshot\" option (instead of \"edition\") in the scratch org\n  definition file and set it to the name of the snapshot. Then use \"sf org create scratch\" to create the scratch org.\n\nALIASES\n  $ sf force org snapshot create\n\nEXAMPLES\n  Create a snapshot called \"Dependencies\" using the source scratch org ID and your default Dev Hub org:\n\n    $ sf org create snapshot --source-org 00Dxx0000000000 --name Dependencies --description 'Contains PackageA \\\n      v1.1.0'\n\n  Create a snapshot called \"NightlyBranch\" using the source scratch org username and a Dev Hub org with alias\n  NightlyDevHub:\n\n    $ sf org create snapshot --source-org myuser@myorg --name NightlyBranch --description 'Contains PkgA v2.1.0 and \\\n      PkgB 3.3.0' --target-dev-hub NightlyDevHub\n\nFLAG DESCRIPTIONS\n  -d, --description=\u003cvalue\u003e  Description of snapshot.\n\n    Use this description to document the contents of the snapshot. We suggest that you include a reference point, such\n    as a version control system tag or commit ID.\n```\n\n_See code: [src/commands/org/create/snapshot.ts](https://github.com/salesforcecli/plugin-signups/blob/2.6.67/src/commands/org/create/snapshot.ts)_\n\n## `sf org delete shape`\n\nDelete all org shapes for a target org.\n\n```\nUSAGE\n  $ sf org delete shape -o \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [--api-version \u003cvalue\u003e] [-p]\n\nFLAGS\n  -o, --target-org=\u003cvalue\u003e   (required) Username or alias of the target org. Not required if the `target-org`\n                             configuration variable is already set.\n  -p, --no-prompt            Don't prompt for confirmation.\n      --api-version=\u003cvalue\u003e  Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Delete all org shapes for a target org.\n\n  A source org can have only one active org shape. If you try to create an org shape for a source org that already has\n  one, the previous shape is marked inactive and replaced by a new active shape. If you don’t want to create scratch\n  orgs based on this shape, you can delete the org shape.\n\nALIASES\n  $ sf force org shape delete\n\nEXAMPLES\n  Delete all org shapes for the source org with alias SourceOrg:\n\n    $ sf org delete shape --target-org SourceOrg\n\n  Delete all org shapes without prompting:\n\n    $ sf org delete shape --target-org SourceOrg --no-prompt\n```\n\n_See code: [src/commands/org/delete/shape.ts](https://github.com/salesforcecli/plugin-signups/blob/2.6.67/src/commands/org/delete/shape.ts)_\n\n## `sf org delete snapshot`\n\nDelete a scratch org snapshot.\n\n```\nUSAGE\n  $ sf org delete snapshot -v \u003cvalue\u003e -s \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [--api-version \u003cvalue\u003e] [-p]\n\nFLAGS\n  -p, --no-prompt               Don't prompt the user to confirm the deletion.\n  -s, --snapshot=\u003cvalue\u003e        (required) Name or ID of snapshot to delete.\n  -v, --target-dev-hub=\u003cvalue\u003e  (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`\n                                configuration variable is already set.\n      --api-version=\u003cvalue\u003e     Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Delete a scratch org snapshot.\n\n  Dev Hub admins can delete any snapshot. Users can delete only their own snapshots, unless a Dev Hub admin gives the\n  user Modify All permission, which works only with the Salesforce license.\n\nALIASES\n  $ sf force org snapshot delete\n\nEXAMPLES\n  Delete a snapshot from the default Dev Hub using the snapshot ID:\n\n    $ sf org delete snapshot --snapshot 0Oo...\n\n  Delete a snapshot from the specified Dev Hub using the snapshot name:\n\n    $ sf org delete snapshot --snapshot BaseSnapshot --target-dev-hub SnapshotDevHub\n\nFLAG DESCRIPTIONS\n  -s, --snapshot=\u003cvalue\u003e  Name or ID of snapshot to delete.\n\n    The IDs of scratch org snapshots start with 0Oo.\n```\n\n_See code: [src/commands/org/delete/snapshot.ts](https://github.com/salesforcecli/plugin-signups/blob/2.6.67/src/commands/org/delete/snapshot.ts)_\n\n## `sf org get snapshot`\n\nGet details about a scratch org snapshot.\n\n```\nUSAGE\n  $ sf org get snapshot -v \u003cvalue\u003e -s \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [--api-version \u003cvalue\u003e]\n\nFLAGS\n  -s, --snapshot=\u003cvalue\u003e        (required) Name or ID of snapshot to retrieve.\n  -v, --target-dev-hub=\u003cvalue\u003e  (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`\n                                configuration variable is already set.\n      --api-version=\u003cvalue\u003e     Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Get details about a scratch org snapshot.\n\n  Snapshot creation can take a while. Use this command with the snapshot name or ID to check its creation status. After\n  the status changes to Active, you can use the snapshot to create scratch orgs.\n\n  To create a snapshot, use the \"sf org create snapshot\" command. To retrieve a list of all snapshots, use \"sf org list\n  snapshot\".\n\nALIASES\n  $ sf force org snapshot get\n\nEXAMPLES\n  Get snapshot details using its ID and the default Dev Hub org:\n\n    $ sf org get snapshot --snapshot 0Oo...\n\n  Get snapshot details using its name from a Dev Hub org with alias SnapshotDevHub:\n\n    $ sf org get snapshot --snapshot Dependencies --target-dev-hub SnapshotDevHub\n\nFLAG DESCRIPTIONS\n  -s, --snapshot=\u003cvalue\u003e  Name or ID of snapshot to retrieve.\n\n    The IDs of scratch org snapshots start with 0Oo.\n```\n\n_See code: [src/commands/org/get/snapshot.ts](https://github.com/salesforcecli/plugin-signups/blob/2.6.67/src/commands/org/get/snapshot.ts)_\n\n## `sf org list shape`\n\nList all org shapes you’ve created.\n\n```\nUSAGE\n  $ sf org list shape [--json] [--flags-dir \u003cvalue\u003e]\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  List all org shapes you’ve created.\n\n  The output includes the alias, username, and ID of the source org, the status of the org shape creation, and more. Use\n  the org ID to update your scratch org configuration file so you can create a scratch org based on this org shape.\n\nALIASES\n  $ sf force org shape list\n\nEXAMPLES\n  List all org shapes you've created:\n\n    $ sf org list shape\n\n  List all org shapes in JSON format and write the output to a file:\n\n    $ sf org list shape --json \u003e tmp/MyOrgShapeList.json\n```\n\n_See code: [src/commands/org/list/shape.ts](https://github.com/salesforcecli/plugin-signups/blob/2.6.67/src/commands/org/list/shape.ts)_\n\n## `sf org list snapshot`\n\nList scratch org snapshots.\n\n```\nUSAGE\n  $ sf org list snapshot -v \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [--api-version \u003cvalue\u003e]\n\nFLAGS\n  -v, --target-dev-hub=\u003cvalue\u003e  (required) Username or alias of the Dev Hub org. Not required if the `target-dev-hub`\n                                configuration variable is already set.\n      --api-version=\u003cvalue\u003e     Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  List scratch org snapshots.\n\n  You can view all the snapshots in a Dev Hub that you have access to. If you’re an admin, you can see all snapshots\n  associated with the Dev Hub org. If you’re a user, you can see only your snapshots unless a Dev Hub admin gives you\n  View All permissions.\n\n  To create a snapshot, use the \"sf org create snapshot\" command. To get details about a snapshot request, use \"sf org\n  get snapshot\".\n\nALIASES\n  $ sf force org snapshot list\n\nEXAMPLES\n  List snapshots in the default Dev Hub:\n\n    $ sf org list snapshot\n\n  List snapshots in the Dev Hub with alias SnapshotDevHub:\n\n    $ sf org list snapshot --target-dev-hub SnapshotDevHub\n```\n\n_See code: [src/commands/org/list/snapshot.ts](https://github.com/salesforcecli/plugin-signups/blob/2.6.67/src/commands/org/list/snapshot.ts)_\n\n\u003c!-- commandsstop --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalesforcecli%2Fplugin-signups","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsalesforcecli%2Fplugin-signups","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalesforcecli%2Fplugin-signups/lists"}