Skip to main content
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:
The Repositories section of the sidebar with the Add repository menu open, listing Create new repository, Start from GitHub and Start from local folderThe Repositories section of the sidebar with the Add repository menu open, listing Create new repository, Start from GitHub and Start from local folder
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.

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

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