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

# Managing projects

In Piebald, *projects* are the folders that you use to chat and perform agentic development.  If your project is a Git repo with worktrees, the worktrees are treated as projects; otherwise, the folder itself is the project.

### Opening projects

To open a project, open the "NN PROJECTS" dropdown menu from the sidebar and click **Open folder...**

<img class="shadow-md rounded-xl" width="650" alt="projects_open_folder.png" src="https://mintcdn.com/piebald/8Y9BNGsLA7OR-jy1/imgs/projects_open_folder.png?fit=max&auto=format&n=8Y9BNGsLA7OR-jy1&q=85&s=04692c625977eba383a1ef2335bb6c7a" data-path="imgs/projects_open_folder.png" />

Once you've opened a folder, a chat will automatically be created in that project.

### Deleting projects

If you've had a few chats or agentic development sessions in a folder, but now you want to remove the projects, you can delete the project.  Deleting the projects will also delete all chats in that folder.

Open the "NN PROJECTS" dropdown menu, hover your project, and click **Delete**:

<img class="shadow-md rounded-xl" width="650" alt="delete_project.png" src="https://mintcdn.com/piebald/8Y9BNGsLA7OR-jy1/imgs/delete_project.png?fit=max&auto=format&n=8Y9BNGsLA7OR-jy1&q=85&s=c9cd2725445cc46e39ae4f3742a1cb5b" data-path="imgs/delete_project.png" />

You'll be prompted to confirm the deletion. Click **Delete**.

### Renaming projects

Projects can be renamed at any time.  Hover your project and click the settings icon:

<img class="shadow-md rounded-xl" width="350" alt="project_settings_button.png" src="https://mintcdn.com/piebald/8Y9BNGsLA7OR-jy1/imgs/project_settings_button.png?fit=max&auto=format&n=8Y9BNGsLA7OR-jy1&q=85&s=731d12b27532fe63eeec9e383d2f6e98" data-path="imgs/project_settings_button.png" />

Then go to the **General** section and enter a new name for the project.  The project's name instantly updates in the sidebar once you click off or press Enter.
