--- title: "Clone a project" slug: "clone-a-project" description: "Clone an Allspice project to a folder on your computer with Allspice Desktop. Search and sort projects, choose a folder, and start working on files." tags: ["allspice desktop", "version control"] updated: 2026-10-28T20:33:48Z published: 2026-10-28T20:33:48Z canonical: "learn.allspice.io/clone-a-project" --- > ## Documentation Index > Fetch the complete documentation index at: https://learn.allspice.io/llms.txt > Use this file to discover all available pages before exploring further. # Clone a project Clone a project to copy it from Allspice to a folder on your computer. You can then work on its files and send your changes back to Allspice. > **Beta:** Allspice Desktop is in beta and available only to select organizations, as of October 13, 2026. Features, supported systems and these instructions may change between releases, and some features may be incomplete. If your organization doesn't see the **Desktop App** button in Allspice Hub, it isn't part of the beta yet. Contact your Allspice account team to learn more. We welcome your feedback. ## Start a clone If you have no projects in the app yet, select **Clone Project** on the **Create your first project** screen. ![The Create your first project screen](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/03-get-started.png) If you already have projects, select **+** beside **Projects** in the sidebar. Then select **Clone Project**. ![The + menu with Create New Project and Clone Project](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/03-add-project-menu.png) ## Pick a project The app lists the Allspice projects you can access. Each project shows when it was last updated, its default branch, and its size. 1. To find a project, type part of its name or its organization in the search box. 2. To change the order, open the sort menu and select **Last updated**, **Name**, **Created**, or **Size**. ![The sort menu](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/04-clone-sort(1).png) 1. Select a project. 2. Select **Continue**. ![A project selected in the Clone a project list](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/04-clone-pick.png) ## Choose a folder The app suggests a folder in `~/Documents/AllSpice/`, named after the project. 1. To use another location, select **Choose…** and pick a folder. You can also type a full path in **Clone to**. 2. Select **Clone project**. ![The Choose a folder screen](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/04-clone-folder.png) The folder must not exist yet. If it does, the app asks you to choose a different folder. ## Wait for the clone to finish The app shows its progress while it copies the project. ![The clone progress screen](https://cdn.document360.io/3d44af5c-3f49-4ca5-b152-10836a885c13/Images/Documentation/04-clone-progress.png) When the clone finishes, the app opens the project. If the project has a `develop` branch, the app switches to it. ## Next step [Work on a project](/v1/docs/work-on-a-project)