Skip to main content
The features in this guide are only available in the Subframe desktop app. Download the desktop app for macOS ↗.
The desktop app connects each Subframe project to one local folder at a time. Use a separate Subframe project for each folder so your designs and code stay paired.

​
Connecting a local folder

  1. Open Agent chat
  2. Click Connect to codebase above the chat box
  3. Select a repository, worktree, or local folder
The agent can now read and edit files inside that folder and start its development server. You can also connect a folder by clicking Connect codebase from a new browser tab. Once connected, ask the agent to make changes in your code.

​
Checking your branch and changes

The codebase bar above the chat box shows the connected repository, current branch, and the number of lines added or removed. Hover over it to see the full folder path and Git status. Check this bar before sending a code change to make sure the agent is working in the right folder and branch.

​
Changing the connected folder

  1. Click the connected codebase above the chat box
  2. Select Change folder…
  3. Select the new folder

​
Disconnecting the folder

  1. Click the connected codebase above the chat box
  2. Select Disconnect folder
Disconnecting removes the agent’s access to that folder. It does not delete or change any files.
Last modified on September 19, 2026