---
title: Projects
description: Organize your work into projects and switch between them.
---

# Projects

A project is a folder on your computer that OpenChamber keeps track of — usually one codebase. Switching projects switches the folder the agent works in, along with that project's sessions and settings.

## Add a project

You can add a project from a few places:

- the **Add project** entry in the command palette
- the **+** button at the top of the session sidebar
- the folder browser when you pick a directory

Point it at a folder and OpenChamber remembers it. The name comes from the folder; you can change it later.

## Switch projects

Pick a project from the sidebar to make it active. Everything — sessions, git, notes — follows the project you have open.

## Make a project recognizable

Open **Settings → Projects** to give a project a custom name, color, or icon. OpenChamber tries to find an icon automatically — see [Project icons](/project-icons/).

> In VS Code, OpenChamber always uses the folder you have open as the only project, so there's nothing to add or switch. The Projects settings page is hidden there.

## Related

- [Project Notes, Todos & Plans](/notes-todos-plans/) — keep working notes per project
- [Project Actions](/project-actions/) — save commands you run often
- [Context](/context/) — see how much of the model's memory a session is using
