mcpField
S
switching-org

switching-org

github.com/forcedotcomCloud & DevOps1.1k3.7k installsUpdated 1d ago
Repository

About switching-org

A skill for setting and verifying the Salesforce CLI default org. It guides project-local configuration by default and reserves global changes for explicit requests.

Key features

  1. 01Choose an org by username or alias
  2. 02List authenticated orgs when unspecified
  3. 03Set project-local target org
  4. 04Set global target org on request
  5. 05Verify the configured org

Use cases

  1. 01Set the org for work in the current project
  2. 02Select an authenticated org when no alias is known
  3. 03Configure an org globally when explicitly requested

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/forcedotcom/sf-skills --skill switching-org

After installing, type/switching-orgin Claude Code to confirm it loaded.

Details

From the project README

Steps

  1. Identify the org: the user provides a username or alias (orgIdentifier). If not provided, run sf org list to show authenticated orgs and ask the user which one to use.
  2. Set the default org:
    • Local (default): sf config set target-org <orgIdentifier>
      • Applies only within the current project directory. Use this for normal project work.
    • Global (only if user explicitly requests): sf config set target-org <orgIdentifier> --global
      • Applies system-wide across all directories. Use when working outside a project or when the user asks for global scope.
    • If this fails, report the error and suggest running sf org login web if the org may not be authorized.
  3. Verify:
    • sf config get target-org --json
    • Note: the JSON output does not include a scope/location field — it cannot confirm whether the value is local or global. Confirm the value only, e.g.: target-org is now set to: <value>
    • If it fails, report the error and advise running sf config get target-org.

Notes

Comments

Markdown supported