Use Agentforce Vibes in a Scratch Org

Agentforce Vibes works in scratch orgs without admin involvement. Developers control access through the definition file.

To control access for a specific scratch org, edit config/project-scratch-def.json in your Salesforce DX project.

Agentforce Vibes is available in these scratch org editions:

  • Developer Edition
  • Enterprise Edition

Starting in Summer ‘26, add AgentforceVibesUnmeteredAccess to the features array in your scratch org definition file to enable unmetered access in a scratch org. After creating the org, also assign the required permission set to your user.

Add the feature flags to config/project-scratch-def.json:

Then create the scratch org:

or use the VS Code command, SFDX:Create a Default Scratch Org…

Follow the steps in Create and Assign the Unmetered Permission Set to create and assign the unmetered permission set to your user.

After you authenticate to this scratch org in the Agentforce Vibes extension, your user is recognized as an unmetered user.

Scratch orgs with AgentforceVibesUnmeteredAccess get the same model access and limits as the standard unmetered tier.

The ability to create scratch orgs using flex credits will be available in an upcoming release.

To disable Agentforce Vibes for a specific scratch org, add the opt-out setting to config/project-scratch-def.json:

These changes take effect for new scratch orgs created from this definition file. Active scratch orgs aren’t affected.

  • No admin setup required. Unlike production and sandbox orgs, the developer controls scratch org access through the definition file, not through Setup.
  • Dev Hub is the gate. If your Dev Hub doesn’t have Agentforce Vibes enabled, scratch orgs don’t have it either, regardless of what you put in the definition file. Contact your admin to confirm the Dev Hub state.