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 your 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.

​
Starting from a starter project

If you don’t have a codebase yet, create a starter project instead. It is a new React app built with Vite and Tailwind CSS, with your project’s components and theme already synced.
  1. Open Agent chat in a project with no connected codebase
  2. Click Use a starter project
  3. Choose where to save the new folder
Subframe creates the folder and connects it to your project.

​
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 25, 2026