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

# Add a repository

> Start from a GitHub repository, a folder on your computer or a new repository, turn a quick chat into a repository, and switch GitHub accounts. Your code stays on your computer.

Add a repository to work on its code with your agent next to the canvas. You can start from GitHub, from a folder on your computer or from nothing, and Wonder keeps the code on your computer.

**Before you start** · Desktop app · Free plan

Wonder includes Git and the GitHub CLI, so you don't need to install either.

## Add a repository

1. In the sidebar, click **Add repository** (the folder with a plus) next to **Repositories**. If you have no repositories yet, click **Add a repository…**.
2. Choose how to start:
   * **Create new repository**: an empty repository. See [Create a new repository](#create-a-new-repository).
   * **Start from GitHub**: clone a repository you can access on GitHub. See [Start from GitHub](#start-from-github).
   * **Start from local folder**: a folder already on your computer. See [Start from a folder on your computer](#start-from-a-folder-on-your-computer).

![The Repositories section of the sidebar with the Add repository menu open, listing Create new repository, Start from GitHub and Start from local folder](https://mintcdn.com/wonder-0722b0f6/Ig4tBDjfjeU3SKs6/images/work-with-your-code/add-repository-menu.light.webp?fit=max\&auto=format\&n=Ig4tBDjfjeU3SKs6\&q=85\&s=ec0f973a0c4118b80ff5fb832176b9cf)

![The Repositories section of the sidebar with the Add repository menu open, listing Create new repository, Start from GitHub and Start from local folder](https://mintcdn.com/wonder-0722b0f6/Ig4tBDjfjeU3SKs6/images/work-with-your-code/add-repository-menu.dark.webp?fit=max\&auto=format\&n=Ig4tBDjfjeU3SKs6\&q=85\&s=0950ee5dd47f5d6e0f7494fc82983c81)

The same three choices are in the repository menu at the top of the window, next to the repository's name.

However you start, Wonder adds the repository to the sidebar, makes its first worktree and opens a chat there. A worktree is a separate copy of your repository on its own branch; see [Worktrees and parallel agents](https://wonder.design/docs/worktrees-and-parallel-agents.md).

## Start from GitHub

1. Choose **Start from GitHub**. **Connect a GitHub repository** opens.
2. If Wonder isn't signed in to GitHub yet, click **Continue with GitHub** and [sign in](#sign-in-to-github).
3. Find the repository. The menu above the list starts on **All accounts**: your own account and the organizations you belong to. Repositories you're a collaborator on are under **Shared with me**. Type in **Search repos** to narrow the list.
4. Click the repository.

Wonder clones it into your [Wonder folder](#where-wonder-keeps-your-code). While it clones, its row in the sidebar says **Cloning…**; click **Cancel clone** to stop. You can start other clones in the meantime.

If an organization's repositories are missing, Wonder may say that GitHub is withholding them until you authorize the GitHub CLI there, for single sign-on or an organization owner's approval. Click **Authorize on GitHub** and follow the steps on GitHub.

## Start from a folder on your computer

1. Choose **Start from local folder**.
2. Pick the repository's folder and click **Open**.

Wonder adds a Git repository where it is: it doesn't move or copy the folder. Its worktrees go in your Wonder folder.

If the folder isn't a Git repository, Wonder asks **Set up Git in …?**:

* **Set up Git** makes it a repository. Wonder saves the folder's current files as the first commit and leaves out secrets, dependencies and build output.
* **Skip, work without Git** adds the folder as it is. Chats work in the folder itself, and you can't make worktrees until you set up Git. You can do that later in the repository's **Repository settings**.

If a cloud service such as iCloud Drive or Dropbox syncs the folder, Wonder warns that syncing can damage Git's files, and the button reads **Set up Git anyway**. A folder outside the synced one is safer.

## Create a new repository

1. Choose **Create new repository**.
2. Type a **Repository name**. If the folder's name will differ from what you typed, for example because of spaces, Wonder shows it under the field as **Created as …**.
3. Click **Create repository**.

Wonder makes an empty repository on a `main` branch in your Wonder folder. It's only on your computer until you publish it: see [Publish a repository to GitHub](https://wonder.design/docs/commit-push-and-pull-requests.md#publish-a-repository-to-github).

## Turn a quick chat into a repository

A quick chat has no repository. When one turns into a project you want to keep:

1. Open the quick chat's menu in the sidebar, or the menu at the top of the window, and choose **Turn into a repository**.
2. Change the **Repository name** if you like. It starts from the chat's title.
3. Click **Create repository**.

Wonder makes a repository in your Wonder folder, puts the quick chat's files in its first worktree as uncommitted changes and continues the chat there. The quick chat is archived. The notice that follows offers **Publish to GitHub**.

**Turn into a repository** waits while the chat is busy. Its note says what to do first, such as **Available when the agent finishes**, **Save or close its edited files first** or **Stop its Preview first**.

## Sign in to GitHub

Wonder uses your own GitHub CLI login, and never stores a GitHub token itself. If you've already signed in with `gh` in your terminal, Wonder uses that login, and signing in from Wonder signs in the GitHub CLI on your computer.

1. Click **Continue with GitHub**, or **Sign in to GitHub** wherever Wonder offers it. **Sign in to GitHub** opens with a one-time code, and GitHub opens in your browser.
2. Enter the code on that page and approve **GitHub CLI**. The window finishes on its own.

Click **Copy code** to copy the code, or **Open GitHub again** if you closed the page.

## Switch GitHub accounts

1. Choose **Start from GitHub**.
2. Click **Switch account** next to **Connected as**, or choose **Switch GitHub account** at the bottom of the account menu.
3. Pick an account, or click **Add another account** to sign in with a new one.

Switching changes the account the GitHub CLI uses on this computer, so `gh` in your terminal switches too.

## Where Wonder keeps your code

Your code stays on your computer, in your Wonder folder, `~/wonder` unless you change it:

| What | Where |
| - | - |
| Repositories you clone from GitHub or create | `~/wonder/repos/` |
| Worktrees | `~/wonder/workspaces/`, in a folder named after the repository |
| A folder you started from | Where it already was |

To see a repository's folder, open its menu in the sidebar and choose **Show in Finder**.

### Change the Wonder folder

1. Open **Settings > Agents** and find **Wonder folder** under **Projects and worktrees**.
2. Click **Change…** and choose a folder. **Use default** goes back to `~/wonder`.

New repositories and worktrees go to the new folder; existing ones stay where they are. To move them too, click **Move existing projects and worktrees**. Repositories you added from their own folder stay where they are.

## Remove a repository

1. Click **⋯** on the repository in the sidebar, or right-click it.
2. Choose **Remove repository** and confirm.

Removing deletes the repository's worktrees and archived worktrees, and any uncommitted changes in them. The repository's own folder isn't deleted, even if Wonder cloned it.

To tidy the sidebar without removing anything, choose **Hide from sidebar** instead.

## If something goes wrong

* **"Couldn't clone this repository because Wonder isn't signed in to GitHub, or its sign-in expired".** Click **Sign in to GitHub** on the repository's row, then **Try again**.
* **"That repository was not found".** Your GitHub account can't see it. Check your access on GitHub, or [switch to the account](#switch-github-accounts) that has it.
* **"No repositories yet".** The signed-in account has no repositories Wonder can list. Check which account it is, or click **Switch GitHub account**.
* **"Your organization requires single sign-on for GitHub".** Sign in to GitHub again and authorize the organization.
* **"Your organization blocks the GitHub CLI through its OAuth app policy".** Ask an organization owner to allow the GitHub CLI.
* **"That sign-in code expired before GitHub confirmed it".** Start the sign-in again to get a new code.
* **"This folder is too broad to become one repository".** You picked your home folder, a disk, Desktop, Documents, Downloads or a cloud-sync folder. Choose the repository's own folder.
* **"This folder has more than 10,000 files or 500 MB to commit".** Leave large folders out with a `.gitignore`, or ask your agent to, then try again.
* **"This folder is already a repository".** Add it with **Start from local folder** instead of creating it.
* **"The repository folder already has files in it".** Wonder never writes over them. Pick another name.
* **"There isn't enough free disk space to clone this repository".** Free up space, for example by deleting archived worktrees, then try again.

## Related

* [Worktrees and parallel agents](https://wonder.design/docs/worktrees-and-parallel-agents.md)
* [Commit, push and pull requests](https://wonder.design/docs/commit-push-and-pull-requests.md)
* [Manage your chats](https://wonder.design/docs/manage-your-chats.md)
* [Bring your code onto the canvas](https://wonder.design/docs/bring-your-code-onto-the-canvas.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.