---
schema_version: "1"
id: 02e320864a476361a2b1bafd24297c3ac7f6a32b9bb899c702f5634602e008c2
title: Create an Agentforce-Ready Scratch Org With Salesforce CLI
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/genai/agentforce/guides/scratch-org.md
canonical_url: https://developer.salesforce.com/docs/ai/agentforce/guide/scratch-org.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 65b38e075c6ae133a6534eeb46d462bfe99b1ccc6c263b926ff88d3f4cba73a3
products:
  - Agentforce Developer Guide
  - Agentforce and Einstein Generative AI
---
# Create an Agentforce-Ready Scratch Org With Salesforce CLI

This guide describes the basic steps for using Salesforce CLI to create a generative AI scratch org for a Developer or Enterprise edition org. You can use either a [sandbox or a scratch org](https://developer.salesforce.com/docs/ai/agentforce/guide/agentforce/agent-dx/agent-dx-set-up-env.md#sandbox-versus-scratch-org) to develop and test your agents. If your agent needs Agentforce Data Library (ADL) or other Data 360 features, we recommend using a sandbox. For more information on the Agentforce developer lifecycle, see [Build Agents with Agentforce DX](https://developer.salesforce.com/docs/ai/agentforce/guide/agentforce/agent-dx/agent-dx.md)

**note:** A [scratch org](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_scratch_orgs.htm) is a configurable, short-term Salesforce environment that you can quickly spin up when starting a new project, a new feature branch, or a feature test. Unlike a sandbox, a scratch org doesn't contain data or metadata from your production org. Scratch orgs are configured using a scratch org definition file, which lists the features and settings that mirror the customer's production org.

1. Install [Salesforce CLI](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_install_cli.htm) on your computer.

2. Open a terminal (macos, Linux) or command prompt (Windows) and make sure that Salesforce CLI is up to date by running this command.

   ```bash
sf update
```

3. (Optional) [Create a Salesforce DX project](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_ws_create_new.htm) on your computer and change to the directory.

   If you only want to create a scratch org, then this step isn't necessary. But we recommend creating a DX project if you plan to store your org’s metadata (code and configuration), org templates, sample data, and tests in a version control system. See [Project Setup](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_workspace_setup.htm).

4. Select and enable your Dev Hub org, which must have your Data 360 licenses. See [Select and Enable a Dev Hub Org](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_setup_enable_devhub.htm) in the Salesforce DX Developer Guide for more information.

5. Log in to your Dev Hub org and allow access. In the browser window that opens, sign in to your org with your Salesforce login credentials. Click **Allow**, which allows Salesforce CLI to access to your org.

   ```bash
sf org login web --set-default-dev-hub --alias DevHub
```

6. Create a definition file, such as `afdx-scratch-def.json`. If you're using a Salesforce DX project, create the file in the `config` directory alongside the existing `config/project-scratch-def.json` file.

   To use an Einstein Generative AI scratch org, add the `Einstein1AIPlatform` feature, which is supported in Developer and Enterprise editions. To automatically enable Einstein and Agentforce, turn on the `agentPlatformSettings.enableAgentPlatform` and `einsteinGptSettings.enableEinsteinGptPlatform` settings.

   ```json
{
     "orgName": "Agentforce scratch org",
     "edition": "Developer",
     "features": ["EnableSetPasswordInApi","Einstein1AIPlatform"],
     "settings": {
       "lightningExperienceSettings": {
         "enableS1DesktopEnabled": true
       },
       "mobileSettings": {
         "enableS1EncryptedStoragePref2": false
       },
       "agentPlatformSettings": {
         "enableAgentPlatform": true
       },
       "einsteinGptSettings" : {
         "enableEinsteinGptPlatform" : true
       }
     }
   }
```

7. Using the scratch org definition file, create the scratch org.

   ```bash
sf org create scratch --definition-file config/afdx-scratch-def.json --alias MyScratchOrg --set-default --target-dev-hub DevHub
```

8. Open the org.

   ```bash
sf org open --target-org MyScratchOrg
```

After you open the org, you can use Salesforce generative AI features such as Agentforce, Prompt Builder, Model Builder, and the Models API. To learn more, see [Agentforce and Einstein Generative AI](https://help.salesforce.com/s/articleView?id=ai.generative_ai.htm) in Salesforce Help.

## See Also

- [Set Up Einstein Generative AI and Agentforce](https://developer.salesforce.com/docs/ai/agentforce/guide/org-setup.md)
- [AgentPlatformSettings Metadata API](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_agentplatformsettings.htm)
- [EinsteinGptSettings Metadata API](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_einsteingptsettings.htm)