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

# Projects in Orq.ai

> Organize AI resources with projects. Group prompts, deployments, agents, and knowledge bases. Manage team access and permissions for isolated environments.

Projects are the top-level organizational unit in **Orq.ai**. Each project is a workspace-level container that holds **Deployments**, **Prompts**, **Agents**, **Knowledge Bases**, and **Datasets**. Create separate projects to isolate environments, control team access independently, and keep observability data scoped per use case. For example, separate production and staging into distinct projects to scope API keys, permissions, and trace data independently.

Projects appear as a project name dropdown in the top bar.

## Using Projects

**Switching projects**

Click the project name in the top bar to open the project dropdown. Search for a project, select one from the list, or click **Create New Project**.

<Frame caption="Select or create a Project from the top bar dropdown.">
  <img src="https://mintcdn.com/orqai/PmB2dfYcRDbvzd7F/images/sidebar-v2-project-dropdown.png?fit=max&auto=format&n=PmB2dfYcRDbvzd7F&q=85&s=e3487e06ac644b68859d3100235e4c6d" alt="Project dropdown in the top bar showing All Projects, Default Project, TestProject, and a Create New Project option" width="721" height="574" data-path="images/sidebar-v2-project-dropdown.png" />
</Frame>

**Editing or deleting a project**

Click the <kbd><Icon icon="ellipsis" /></kbd> menu next to a project name in the dropdown to **Edit** the project name or **Delete** the project.

<Frame caption="Edit or delete a project from the project dropdown menu.">
  <img src="https://mintcdn.com/orqai/PmB2dfYcRDbvzd7F/images/docs/edit-delete-project-411.png?fit=max&auto=format&n=PmB2dfYcRDbvzd7F&q=85&s=108b3e14fcdba323a32af59133d13c59" alt="Project dropdown with the ellipsis menu open on a project row, showing Edit and Delete options" width="620" height="412" data-path="images/docs/edit-delete-project-411.png" />
</Frame>

<Note>
  A project can only be deleted if it's empty. Remove all entities from the project first.
</Note>

## Browsing Projects

Use **Directory** in the sidebar to view all entities in the current project. The breadcrumb shows which project is active.

<Frame caption="Directory view showing all entities in the Default Project with last update date and team member.">
  <img src="https://mintcdn.com/orqai/PmB2dfYcRDbvzd7F/images/directory-sidebarv2-411.png?fit=max&auto=format&n=PmB2dfYcRDbvzd7F&q=85&s=35769442213f538283c2f4122cf0e97c" alt="Directory view listing all entity types in a flat list with Name, Last Update, and Updated by columns, plus Search, Filter, and Create controls" width="1411" height="716" data-path="images/directory-sidebarv2-411.png" />
</Frame>

The directory lists all entity types in a single flat view: **Evaluators**, **Deployments**, **Knowledge Bases**, **Experiments**, **Agents**, **Playgrounds**, and more. Use **Search** and **Filter** to narrow the list, or click <kbd>+ Create</kbd> to add a new entity directly from the directory.

## Permissions

When creating a project, assign which **Teams** have access. Each team has members with different access levels across the project entities.

<Frame caption="Choose which team to add to a Project.">
  <img src="https://mintcdn.com/orqai/iV1P61Ac2GbluSfe/images/create-projects-members.png?fit=max&auto=format&n=iV1P61Ac2GbluSfe&q=85&s=e0540fb0ff30a767e2cad94d3b10e6e2" alt="Project creation dialog showing a team selector with access level options" width="679" height="392" data-path="images/create-projects-members.png" />
</Frame>