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

# Spaces overview

> A Space is where your team and your agents work together. Learn what a Space is and how to create one.

A Space is a shared workspace for a team and its agents. Everything relevant to a project or workflow lives here: conversations, docs, the Space Context document, artifacts, and agent activity.

When your team works in a Space, your agents build up shared context from it. The next question in that Space already has the background.

<Frame>
  <img src="https://mintcdn.com/hopsdocs/aPzvROLR1ys8NZS5/images/what-is-a-space.png?fit=max&auto=format&n=aPzvROLR1ys8NZS5&q=85&s=78ab6a7773343d672d4a83eb9d3da5b4" alt="A Hops Space showing the sidebar with multiple Spaces and agents, and a chat thread inside the selected Space." width="3018" height="1718" data-path="images/what-is-a-space.png" />
</Frame>

## How Spaces work

**One Space, one shared context.** Everything in a Space — decisions, drafts, threads, docs — contributes to the shared context your agents draw from.

**People and agents work side by side.** Tag `@Hops` or any custom agent in a thread. A Space can have multiple agents; tag different ones in the same conversation and each responds from its own specialization.

**Spaces are scoped.** An agent working in one Space doesn't automatically carry that context into another. You control what each Space contains and who can see it.

<Tip>
  Set up the [Space Context document](/docs/spaces/space-context) early. It's the single fastest way to make every agent in the Space sharper — one brief every agent reads before responding.
</Tip>

## Space visibility

Every Space is either public or private inside your workspace. You pick when you create it and can change it later.

| Visibility  | Who can see it                               | Good for                                            |
| ----------- | -------------------------------------------- | --------------------------------------------------- |
| **Public**  | Everyone in your workspace can find and join | Team channels, company-wide projects                |
| **Private** | Only invited members and agents              | Client work, confidential launches, exec-only rooms |

<Note>
  Private Spaces are hidden from search for people who aren't invited. Agents scoped to a private Space only draw context from it.
</Note>

## Work with multiple agents in one thread

A Space can have several agents. Tag them in the same conversation and each one responds from its own instructions and connected tools.

```
@Researcher pull the latest competitor pricing for Q3
@Copywriter turn those findings into three subject-line options
@SDR draft a follow-up to yesterday's demo using the new positioning
```

Each `@` tag routes the request to that agent. Replies land in the same thread so the whole team (and every other agent) sees the context.

## Create a Space

<Frame>
  <img src="https://mintcdn.com/hopsdocs/aPzvROLR1ys8NZS5/images/create-a-space.gif?s=feabe06910bcef14cf689c61969e1dac" alt="Creating a new Space by clicking the + button and naming it." width="900" height="524" data-path="images/create-a-space.gif" />
</Frame>

<Steps>
  <Step title="Click the + button">
    At the bottom of the left sidebar, click **+** and select **Space**.
  </Step>

  <Step title="Name your Space">
    Give it a clear, specific name. The name tells your team and your agents what this Space is for.

    Good examples: `Product launch Q3`, `Acme Corp account`, `Marketing team`.
  </Step>
</Steps>

Your Space is ready. Start a thread, [set up the Space Context document](/docs/spaces/space-context), or tag an agent to get to work.

## Add agents to a Space

Every Space has `@Hops` by default. To bring in **custom agents** — for example a Legal helper, a Researcher, or an SDR — invite them from the Space's **Agents** panel.

<Frame>
  <img src="https://mintcdn.com/hopsdocs/6g4tmvgWdeoeLgJC/images/add-agents-to-teams.gif?s=e3414f3bab20d2ada69d8339fcd88277" alt="Inviting a custom agent into a Space from the Agents panel." width="1252" height="720" data-path="images/add-agents-to-teams.gif" />
</Frame>

<Steps>
  <Step title="Open the Agents panel">
    Inside your Space, open the **Agents** tab in the right rail.
  </Step>

  <Step title="Add an agent">
    Click **Add agent** and pick from your custom agents (or create a new one on the fly).
  </Step>

  <Step title="Tag them in chat">
    In the Space's chat, tag any agent with `@name`. Multiple agents can work in the same thread, each responding from its own instructions and tools.
  </Step>
</Steps>

<Tip>
  Only add the agents a Space actually needs. Fewer, more specialized agents give sharper, less noisy responses.
</Tip>

See [Agents](/docs/agents/overview) and [Custom agents](/docs/agents/custom-agents) for more.

## When to create a new Space

Create a Space for a distinct project, team, or ongoing workflow:

| Type               | Good for                                             |
| ------------------ | ---------------------------------------------------- |
| **Project**        | A specific initiative with a start and end           |
| **Team channel**   | An ongoing team with recurring workflows             |
| **Client account** | All context for one external relationship            |
| **Process**        | A repeating workflow (hiring, onboarding, reporting) |

<Tip>
  Keep one Space per topic. Mixing unrelated projects dilutes the context and makes agents less accurate.
</Tip>

## What's inside a Space

<CardGroup cols={2}>
  <Card title="Chat" icon="message" href="/docs/spaces/chat">
    Threaded conversations with your team and your agents. Also where pins and meetings live.
  </Card>

  <Card title="Space Context" icon="thumbtack" href="/docs/spaces/space-context">
    A standing brief every agent in the Space reads before responding.
  </Card>

  <Card title="Automation" icon="calendar" href="/docs/spaces/automation">
    Scheduled tasks that run on their own.
  </Card>

  <Card title="Members" icon="users">
    People and agents in the Space, and their roles.
  </Card>
</CardGroup>

Docs, files, and tables created in a Space also show up in the global [Artifacts](/docs/artifacts/overview) tabs in the left sidebar.

## Common Space setups

Not sure how to structure your first few Spaces? Start from a proven pattern.

<CardGroup cols={3}>
  <Card title="Marketing" icon="megaphone" href="/docs/teams/marketing/overview">
    Campaign launches, content repurposing, and brand copywriting in one room.
  </Card>

  <Card title="Sales" icon="chart-line" href="/docs/teams/sales">
    Pre-call prep, post-call follow-ups, and clean deal handoffs.
  </Card>

  <Card title="Legal" icon="scale-balanced" href="/docs/teams/legal">
    Contract summaries, NDA prep, and compliance Q\&A with a Legal helper agent.
  </Card>
</CardGroup>

See [Teams & Use cases](/docs/teams/founders-executives) for every team's playbook.
