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

# Space

> Organize personal and team memory in ByteRover spaces.

Spaces are the memory boundary in ByteRover. Your agent queries and records memory inside the active space for the project.

<img src="https://mintcdn.com/byterover-d775e347/P61ogOq6zTX8Li0g/v4/assets/Sharing.png?fit=max&auto=format&n=P61ogOq6zTX8Li0g&q=85&s=3a6b99cc105ee3202a14e22d599d887f" alt="ByteRover Desktop space sharing screen" width="760" data-path="v4/assets/Sharing.png" />

Use spaces to keep personal work, team work, and shared project memory separated.

## Space levels

ByteRover Desktop organizes spaces into three levels.

* **Shared with me** is global. It shows spaces shared to you from another person or another team. These can come from a direct invite or from a team-wide share.
* **Private** belongs to the selected team view. These are personal spaces under the selected team. They are private by default, but you can share them with people inside or outside the team.
* **Team space** belongs to the selected team view. These spaces are visible to the selected team, and you can still share them with people outside the team when the project needs cross-team access.

## Choose the right level

Before starting an agent session, open the space that matches the work you are doing.

* Use **Private** for experiments, personal notes, or work that is not ready for the team.
* Use **Team space** when teammates should reuse the same project memory.
* Use **Shared with me** when another person or team has shared memory with you.

The connected agent will query and record against the selected space.

## Create a space

In the sidebar, select the `+` button beside **Private** or **Team space**.

When creating a space, choose its visibility:

| Visibility      | Use it when                                                     |
| --------------- | --------------------------------------------------------------- |
| **Private**     | Only you should see the space first. You can share it later.    |
| **Team shared** | Everyone in the selected team should be able to view the space. |

Only Owners and Admins can create team spaces. Members can use spaces they have access to, but cannot create a new team-wide space.

## Share with specific people

Open the space, select **Share**, then add a person by email.

Choose a role before you add them:

| Role in Share dialog | What it allows                                                  |
| -------------------- | --------------------------------------------------------------- |
| **Owner**            | Add contexts, manage members, share links, and manage settings. |
| **Admin**            | Add contexts, manage members, and share links.                  |
| **Editor**           | Add contexts and view memory.                                   |
| **Viewer**           | View memory only.                                               |

Use **Viewer** when someone only needs to read memory. Use **Editor** when their agent should record new context into the space.

You can share a private space or a team space with people outside the selected team. The invited person will see it under **Shared with me**.

## Set general access

In the Share dialog, use **General access** to choose who can open the space.

| Option          | Use it when                                                   |
| --------------- | ------------------------------------------------------------- |
| **Restricted**  | Only people you added directly should have access.            |
| **Team access** | Everyone in the owning team should be able to open the space. |

When you switch a space from restricted to team access, Desktop shows how many teammates will gain access.

You can also move a space between **Private** and **Team space** from the sidebar. Drag the space into the other section to change who can see it.

## Review shared spaces

Spaces shared with you appear in **Shared with me**.

Shared spaces can come from:

* a direct share to your email
* a team-wide share from another team

If you were added directly, you can leave the shared space from the row menu. If access comes from a team-wide share, access is controlled by the team membership instead.

If the space is view-only, your agent can query memory but cannot record new context.

## Manage a space

Use the row menu on a space to manage it.

| Action             | What it does                                                                     |
| ------------------ | -------------------------------------------------------------------------------- |
| **Rename**         | Changes the space name.                                                          |
| **Share settings** | Opens the Share dialog for people, roles, and general access.                    |
| **Delete**         | Deletes the space when your role allows it. The default space cannot be deleted. |

View-only spaces show a view-only marker. Your agent is read-only in those spaces too.

## Search topics

Use the Desktop search box or `Cmd K` / `Ctrl K` to search topic titles across visible spaces.

Search results are grouped by:

* Private spaces
* Team spaces
* Shared with me

Open a result to jump directly to that topic inside its space.
