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

# Projects

> Create, switch, rename, and delete projects. A project groups your tasks, agents, assets, and experiments.

A **project** groups your tasks, agents, assets, and experiments. Most dashboard work happens inside the project you have selected.

There is no Project settings page. Manage projects from the header **project switcher**.

<img className="block dark:hidden" src="https://mintcdn.com/oqoqo/0N1ap2mLLIECv0P4/images/screenshots/dashboard-map-light.png?fit=max&auto=format&n=0N1ap2mLLIECv0P4&q=85&s=ade99c3f1f08c04710499fc37b01ae8f" alt="Dashboard with the project switcher and navigation areas visible." width="2320" height="1240" data-path="images/screenshots/dashboard-map-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/oqoqo/0N1ap2mLLIECv0P4/images/screenshots/dashboard-map-dark.png?fit=max&auto=format&n=0N1ap2mLLIECv0P4&q=85&s=10489542d55a371cd03a8889c5749be2" alt="Dashboard with the project switcher and navigation areas visible." width="2320" height="1240" data-path="images/screenshots/dashboard-map-dark.png" />

## Create a project

1. Open the project switcher in the dashboard header.
2. Select **New project**.
3. Name the project and create it.

You can also create and manage projects with the [CLI](/operate/cli) or [MCP](/operate/mcp).

## Switch projects

Open the project switcher and select the project you want. Ask Oqo, catalog pages, and experiments follow the selected project.

## Rename a project

1. Open the project switcher.
2. Open the edit control on the project row.
3. Choose **Rename project**.

## Delete a project

1. Open the project switcher.
2. Open the edit control on the project row.
3. Choose **Delete project**.
4. Confirm. Deletion permanently removes the project and everything inside it.

You cannot delete the organization's only project. Create another project first.

Deletion removes tasks, files, machines, skills, MCP servers, CLIs, SDKs, treatments, agents, experiments, runs, evals, and insights in that project.

## CLI

```sh theme={null}
oqoqo projects list
oqoqo projects use <project-id>
oqoqo projects current
oqoqo projects create --name "My project"
oqoqo projects update <project-id> --name "New name"
oqoqo projects delete <project-id>
```

Destructive deletes use a preview plus approval. MCP exposes the same project operations.

## Related pages

<CardGroup cols={2}>
  <Card title="Organization setup" icon="building" href="/setup/organization">
    Shared org settings across projects.
  </Card>

  <Card title="Profile" icon="user" href="/setup/profile">
    Personal settings and Integrations.
  </Card>

  <Card title="CLI" icon="terminal" href="/operate/cli">
    Manage projects from the terminal.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Launch work inside a project.
  </Card>
</CardGroup>
