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

# Teams & Spaces

> Understanding and managing Teams, Spaces, and organization settings

<AccordionGroup>
  <Accordion title="Do I need a team or space to use ByteRover?">
    No. ByteRover works fully locally without any team or space. Teams and spaces are **cloud-only** features for team collaboration and multi-machine sync.

    You only need them when you want to use `/vc push` and `/vc pull` to sync context between machines or share it with teammates.

    See the [Local vs Cloud](/local-vs-cloud) page for details on what works locally vs what requires cloud.
  </Accordion>

  <Accordion title="What is a Space in ByteRover?">
    A **space** is a shared context container that can include multiple related projects. It is intentionally not limited to a single project, which is why we use the term *space* instead of *project*.

    For example, if you have:

    * `byterover-ui`
    * `byterover-backend`
    * `byterover-agent`

    You can place all three under one space to share and reuse context across them.

    <Note>
      Spaces are a **cloud-only** feature that requires authentication. Local usage does not require spaces.
    </Note>
  </Accordion>

  <Accordion title="Can one space be used for multiple projects?">
    Yes. A single space can contain multiple projects, and this is a supported workflow. You can already use this setup today without issues.
  </Accordion>

  <Accordion title="What is a Team in ByteRover?">
    A **team** is functionally equivalent to an organization. Teams are used to manage members, spaces, and access control.

    <Note>
      Teams are a **cloud-only** feature. Local usage — curate, query, providers, connectors — works without being in a team.
    </Note>
  </Accordion>

  <Accordion title="Can I manage teams and spaces from the CLI?">
    You can manage spaces from the CLI using Git-Semantic version control:

    **In the REPL:**

    ```
    /vc remote set-url origin https://byterover.dev/<team>/<space>.git
    ```

    **From the CLI:**

    ```bash theme={null}
    brv vc remote set-url origin https://byterover.dev/<team>/<space>.git
    ```

    <Note>`brv space list` and `brv space switch` are deprecated in v3.0.0. Use `brv vc remote` to manage remote connections instead.</Note>

    **Creating, renaming, and deleting** teams and spaces is done via the [web app](https://app.byterover.dev/).
  </Accordion>

  <Accordion title="How do I manage my team's spaces and members?">
    To access team settings, click on your **team name** in the top left corner of the [web app](https://app.byterover.dev/) and select **"Manage Team"**.

    From the Settings page, you can:

    **Manage Spaces** — Create, rename, or delete spaces from the **Spaces** tab.

    <Frame>
      <img src="https://mintcdn.com/demo-a750c123/on18B00443Sunmg3/images/faqs-teamSpace-mangage-teamSpaces.png?fit=max&auto=format&n=on18B00443Sunmg3&q=85&s=62bacdb46ea5000bdec28068ddf5be2f" alt="Manage Spaces" width="2998" height="1722" data-path="images/faqs-teamSpace-mangage-teamSpaces.png" />
    </Frame>

    **Manage Members** — Add or remove team members from the **Members** tab.

    <Frame>
      <img src="https://mintcdn.com/demo-a750c123/on18B00443Sunmg3/images/faqs-teamSpace-mangage-teamMembers.png?fit=max&auto=format&n=on18B00443Sunmg3&q=85&s=c319590bc9092848b89073855d6b061a" alt="Manage Team Members" width="3022" height="1716" data-path="images/faqs-teamSpace-mangage-teamMembers.png" />
    </Frame>
  </Accordion>

  <Accordion title="How do I track my team's usage?">
    Navigate to **Manage Team → Billing & Usage** to view your team's current plan, seat allocation, and credit consumption.

    <Frame>
      <img src="https://mintcdn.com/demo-a750c123/on18B00443Sunmg3/images/faqs-teamSpace-mangage-usage.png?fit=max&auto=format&n=on18B00443Sunmg3&q=85&s=cf7c97728bc8301e6faddef74451d758" alt="Billing & Usage" width="3022" height="1722" data-path="images/faqs-teamSpace-mangage-usage.png" />
    </Frame>

    Here you can see:

    * **Plan** — Your current subscription tier
    * **Seats** — How many team members are using seats
    * **Plan Credits** — Usage against your monthly credit allocation
  </Accordion>
</AccordionGroup>