Skip to main content

Read the shared project model

The linked folder is the local companion to the shared Ghostable project record.
 Linking a folder lets Desktop find local, non-secret project files such as:
  • .ghostable/ghostable.yaml
  • .ghostable/schema.yaml
  • .ghostable/schemas/*.yaml
Desktop needs that local context for validation, manifest sync, and file export workflows.
  1. Open the project window.
  2. Go to Settings.
  3. Find the Local Folder section.
  4. Click Link Folder and choose the project directory.
After the link is saved, Desktop shows the selected folder path and, when present, the manifest path. Ghostable desktop project settings view showing the linked local folder path and manifest path for the Control Plane project.

​
What You Unlock

  • validation from the Project window,
  • manifest sync,
  • exporting .env files back into the repo,
  • opening the folder or manifest directly from Project Settings.

​
Continue

Sync the manifest

Keep the local Ghostable manifest aligned with the project metadata.

Import and export env files

Use the linked folder for local .env workflows.