Manage Projects

You can manage your projects in Trae, including creating and switching projects.

What is a Workspace?

A workspace is generally a folder opened in Trae. If your project is complex, you can add multiple folders to one workspace for management.

Create a Project

You can create a project in Trae by importing a local folder or cloning a Git repository.

Method 1: Import a Local Folder

1. Click Open a Folder in the middle of the screen or click Select a Project > Open a Folder at the top left.
2. Select a folder and open it in Trae.
3. In the "Trae" would like to access files in your Downloads folder" dialog box, click Allow.
4. In the Do you trust the authors of the files in this folder dialog box:
   • (Optional) Check the Trust the authors of all files in the parent folder "Downloads" checkbox.
   • Afterwards, this pop-up window will not appear again when you open any folder from the Downloads directory in Trae.
   • Click Yes, I trust the authors.
5. The selected folder is opened in Trae, and you can start editing it.

Method 2: Clone a Git Repository from GitHub

1. Click Clone Git Repository in the middle of the screen or click Select a Project > Clone Git Repository at the top left.
2. Click Clone from GitHub.
3. The following dialog box appears.
4. Authorize GitHub to log in to Trae:
   • Click Allow.
   • The following dialog box that displays the authorization code appears.
   • Click Copy & Continue to GitHub.
   • The authorization code is copied and the following dialog box appears.
   • Click Open.
   • You are directed to the following screen for device activation.
   • Follow the on-screen instructions to complete the authorization process.
5. Return to Trae.
6. The box in the top middle of the screen displays a list of clonable repositories.
7. Select a repository from the list. OR Fill in the name or keywords of your desired repository and click Clone from GitHub.
8. In the pop-up window, select a location to save the repository and click Select as Repository Destination.
9. Trae starts to clone the repository. Once complete, the following dialog box appears.
10. Perform one of the following operations as needed:
    • Click Open to directly open the repository in the current window in Trae.
    • Click Open in New Window to open the repository in a new window in Trae.
11. In the Do you trust the authors of the files in this folder dialog box:
    • (Optional) Check the Trust the authors of all files in the parent folder "Downloads" checkbox.
    • Afterwards, this pop-up window will not appear again when you open any folder from the Downloads directory in Trae.
    • Click Yes, I trust the authors.
12. The selected folder is opened in Trae, and you can start editing it.

Method 3: Clone a Git Repository from its URL

This method does not require authorizing GitHub to log in to Trae, and you can clone a repository directly using its URL.

1. Click Clone Git Repository in the middle of the screen or click Select a Project > Clone Git Repository at the top left.
2. In the URL input box, fill in the URL of your target repository and click Clone from URL {URL_name}.
3. In the pop-up window, select a location to save the repository and click Select as Repository Destination.
4. Trae starts to clone the repository. Once complete, the following dialog box appears.
5. Perform one of the following operations as needed:
   • Click Open to directly open the repository in the current window in Trae.
   • Click Open in New Window to open the repository in a new window in Trae.
6. In the Do you trust the authors of the files in this folder dialog box:
   • (Optional) Check the Trust the authors of all files in the parent folder "Downloads" checkbox.
   • Afterwards, this pop-up window will not appear again when you open any folder from the Downloads directory in Trae.
   • Click Yes, I trust the authors.
7. The repository is opened in Trae, and you can start editing it.

Switch to Another Project

When there are multiple projects in Trae, you can switch between them.

1. At the top left of Trae, click Select Project or the name of the project opened in the current window.
2. The following panel that displays the projects recently opened appears.
3. In the Recent list, select the project you want to switch to.
4. Trae opens a new window to load and display the selected project.

Related Articles

• Set up Trae
• What is Trae IDE?
• Manage Extensions
• Getting Started