← LeaderboardThe Skill Leaderboard

dx-org-switch

Switches the active Salesforce org (default target-org) using the Salesforce CLI. Use whenever someone wants to change which org CLI commands run against — whether they say "switch org", "change default org", "set my org to", "use alias", "point to", or describe wanting to work against a specific org, scratch org, sandbox, or production.

Published by forcedotcom ↗forcedotcom/sf-skills

Try your first task

Set the active org for one project

Start a fresh conversation.

Use dx-org-switch to set this project's default target org to the authenticated org alias or username I provide, then verify the configured value.

Required inputs

The current Salesforce project directory.
An authenticated target org's alias or username.
Salesforce CLI sf >=2.0.0.

Pinned workflow prerequisites

Verify one of these original workflows before running this task. These are versioned prerequisites, not a verified current installation.

Agentforce Vibes automatic installation

Salesforce Skills Library; skills are automatically installed and updated. The listed paths are a bounded selection of the library.

For platform-apex-generate and dx-org-switch at runtime: Salesforce CLI sf >=2.0.0.
For platform-apex-generate: Salesforce API version 66.0 or later; for platform-custom-object-generate: API version 60.0 or later.

Pinned prerequisite source ↗

Install from the repository with skills CLI

Salesforce Skills Library from forcedotcom/sf-skills. The listed paths are a bounded selection; the repository contains additional skills.

For platform-apex-generate and dx-org-switch at runtime: Salesforce CLI sf >=2.0.0.
For platform-apex-generate: Salesforce API version 66.0 or later; for platform-custom-object-generate: API version 60.0 or later.

Pinned prerequisite source ↗

Previously published starter task based on a pinned source version; check the source and required inputs before running. Task evidence ↗

SKILL.md

name: dx-org-switchdescription: "Switches the active Salesforce org (default target-org) using the Salesforce CLI. Use whenever someone wants to change which org CLI commands run against — whether they say \"switch org\", \"change default org\", \"set my org to\", \"use alias\", \"point to\", or describe wanting to work against a specific org, scratch org, sandbox, or production."metadata:   version: "1.0"  domains: ["Developer Experience"]  cliTools:     - tool: ["sf"]      semver: ">=2.0.0"

Steps

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.
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.
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

Unified CLI uses keys like target-org and target-dev-hub. Legacy sfdx keys (defaultusername, defaultdevhubusername) are deprecated in this context.
The sf CLI does not have --local or --scope flags for config set. Local scope is the default behavior.
If the org does not change after setting the config, check whether SF_TARGET_ORG is set — environment variables override config values.
Salesforce CLI config (unified) reference: https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_config_commands_unified.htm#cli_reference_config_set_unified