# Organizations and projects

> Group your work: an organization holds projects and vaults, a project holds the folders agents may open.

DevHub arranges your work in three levels. An **organization** is a business or ownership context, such as a company or a team. A **project** is one repository you work on and belongs to an organization. An **MCP folder** is a folder on your disk that belongs to a project; it is what agents can open.

## When to use it

- You add the first folder, and DevHub asks for an organization and a project.
- You work for more than one company or team and want knowledge kept apart. [Business Context](/devhub/features/business-context/index.md) never mixes two organizations in one answer.
- You want to switch a folder off for agents without deleting anything.

## Organizations

Open **Organizations** in the sidebar.

[Screenshot: The Organizations screen with a card for each organization showing its name, description and the number of projects and vaults, and a Global resources card. The sample data shown is made up.]

1. Click **Add organization**.
2. Enter a name and, if you want, a description and a **Logo**.
3. Click **Create**.

Each card shows the number of projects and of vaults of the organization; click either to see them. **Edit** and **Remove** are on the card. An organization cannot be removed while projects or vaults still belong to it. The **Global resources** card reminds you that skills, rules and instructions of the library are shared by every organization.

## Projects

Open **Projects** in the sidebar.

[Screenshot: The Projects screen with project cards, each with its organization, its repository vault, the inherited organization vault and its MCP folders with the state of their index. The sample data shown is made up.]

1. Click **Add project**. A project belongs to an organization, so add one first if you have none.
2. Enter a name, choose the **Organization** and, if you want, add a description and an **Icon**.
3. Click **Add MCP folder** on the project card and choose the folder of the repository.

A project card shows:

- the **Vault** of the repository, with **Open** or **Create**, and the organization vault it **Inherits** from. See [Vaults](/devhub/features/vaults/index.md);
- each MCP folder with the state of its repository index: **Index ready**, **Index stale**, **Not indexed**, and so on, with **Analyze**, **Refresh index**, **Reindex** or **View index** as fits;
- **Context**, which adds the index overview to [AI Context](/devhub/features/ai-context/index.md);
- **Disable** or **Enable**, which switches the folder off or on for agents, and **Remove**.

Use the filters **All**, **Indexed** and **Stale** to narrow the list.

## What removing does

Removing a folder, a project or an organization removes the entry in DevHub. It does not delete the folder or the notes on your disk. A project cannot be removed while MCP folders or vaults are still attached to it.

## Related

- [Vaults](/devhub/features/vaults/index.md)
- [Structure of DevHub](/devhub/concepts/structure/index.md)
- [Setup wizard](/devhub/getting-started/setup-wizard/index.md)