dx-org-switch

Switch the active Salesforce CLI target org using config commands.

Updated Jun 17, 2026
One-click install
npx skills add https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG --skill dx-org-switch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dx-org-switch
Source: https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG/tree/main/.agents/skills/dx-org-switch
Command: npx skills add https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG --skill dx-org-switch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of changing which Salesforce org the CLI uses, so you can move between scratch orgs, sandboxes, and production targets without manual configuration mistakes.

Core Features & Use Cases

  • Org Selection: Accepts a username or alias and sets it as the active target org.
  • Local or Global Scope: Supports project-only changes by default, with an explicit global option when needed.
  • Verification and Fallbacks: Confirms the saved setting and surfaces guidance when the org is not authorized or environment variables override the config.

Quick Start

Ask the assistant to switch the active Salesforce org to the alias or username you provide and confirm that the new target-org is set correctly.

Frequently Asked Questions about dx-org-switch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch the active target org in Salesforce CLI?

Switch the active Salesforce CLI target org by providing a username or alias. The Skill applies the change using sf config set and verifies the new target-org value with sf config get.

Can I change the Salesforce CLI target org globally instead of just for the current project?

Yes, you can change the Salesforce CLI target org globally. The Skill defaults to project-level configuration but supports an explicit global option when you need to apply the org switch across all projects.

What happens if I try to set a Salesforce org alias that is not authorized?

If the Salesforce org alias is not authorized, the Skill surfaces guidance during the target-org switch. It detects the missing authorization and prompts you to authenticate before applying the configuration.

Why is my Salesforce CLI target org not switching after I set a new alias?

Your Salesforce CLI target org may not switch if environment variables override the configuration. The Skill detects these overrides during verification and surfaces guidance so you can resolve the conflict.

Does this Salesforce CLI org switcher work with scratch orgs, sandboxes, and production aliases?

Yes, the org switcher works with scratch orgs, sandboxes, and production aliases. It accepts any valid username or alias and sets it as the active target-org for your Salesforce CLI operations.