Skip to main content

Shadow Workspace

Shadow workspace settings.

The shadow workspace is a feature that allows you to work with a copy of your codebase in a separate location. This is useful when you want to:

  • Try out experimental changes without affecting your main codebase
  • Test AI-generated code in isolation
  • Create temporary branches for specific tasks
  • Work on multiple versions of the same file

Configuration​

You can configure the shadow workspace settings in the Cursor preferences:

  1. Open Settings (Cmd/Ctrl + ,)
  2. Navigate to the "Advanced" section
  3. Find the "Shadow Workspace" settings
  4. Customize the location and behavior

Usage​

The shadow workspace is automatically used when:

  • Running AI-generated code
  • Testing experimental changes
  • Working with temporary files

You can also manually activate the shadow workspace through the command palette.