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

# Spaces

> Spaces are project containers that bring together a task board, chat, files, terminal, and automations in one place.

A space is a self-contained project area inside your workspace. Each space gets its own board for tracking tasks, chat rooms for conversation, a file editor, a browser-based terminal, and an automations page. You can think of it as a dedicated room for a project or team.

## Creating a space

<Steps>
  <Step title="Open the workspace dashboard">
    Select your workspace from the sidebar. The dashboard lists all spaces you have access to.
  </Step>

  <Step title="Create a new space">
    Right-click the workspace name in the sidebar and choose **Create space**. Give the space a name and an optional description.
  </Step>

  <Step title="Open the space">
    Click the space name in the dashboard to open it. From there you can navigate to its board, chat, files, terminal, and automations using the sidebar or the space's navigation.
  </Step>
</Steps>

<Tip>
  Each space starts empty. You add content — tasks, files, chat rooms — after opening it.
</Tip>

## Navigating between spaces

Your workspace dashboard (the top-level view for your workspace) lists every space you can access. Click any space name to jump directly into it. The sidebar also shows spaces when you expand your workspace in the navigation tree.

## Space access control

Not every member of a workspace can see every space. Access is controlled by roles assigned by your workspace owner.

<Note>
  If the dashboard shows no spaces and you expect to have access, it means you have not been assigned a role yet. Ask an owner to assign you a role under **Roles & permissions** (linked from the dashboard header).
</Note>

Roles carry permissions that control what you can do inside a space, including reading or writing the board, chat, files, and terminal. If you can see a space but certain features are greyed out or return errors, your role may not include the required permission for that feature.

<AccordionGroup>
  <Accordion title="Permissions that affect what you can do in a space">
    | Permission | What it controls |
    | - | - |
    | `board.read` / `board.write` | View and edit the task board |
    | `tasks.read` / `tasks.write` | Read and create tasks |
    | `chat.read` / `chat.write` | Read and send chat messages |
    | `files.read` / `files.write` / `files.delete` | Access, edit, and delete files |
    | `terminal.use` | Launch terminal sessions |
    | `space.create` / `space.delete` | Create or delete spaces |

    Your workspace owner configures which permissions each role has.
  </Accordion>
</AccordionGroup>

## Space overview

When you open a space, you land on its home view. From here you can navigate to any of the space's sections:

* **Board** — the kanban board for tracking tasks
* **Chat** — real-time chat rooms scoped to the space
* **Files** — a browser-based editor for your project files
* **Terminal** — SSH connections and a live terminal
* **Automations** — workflows you can build and trigger from the space


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.