> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subframe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting your codebase

> Give the agent access to read, edit, and run your local project.

<Note>
  The features in this guide are only available in the Subframe desktop app. [Download the desktop app for macOS
  ↗](https://subframe.com/downloads).
</Note>

The [desktop app](/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](/browser/previewing-your-local-app).

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](/agent/making-code-changes).

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


## Related topics

- [Connecting an agent](/agent/connecting-an-agent.md)
- [Quickstart](/learn/quickstart.md)
- [Adding custom fonts](/design/theme/adding-custom-fonts.md)