> ## 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.

# Core concepts

> The building blocks of Hops: Spaces, agents, shared context, search, and activity.

Hops has a few key ideas. Once you get these, everything else clicks.

## Spaces

<div style={{ display: "grid", gridTemplateColumns: "1fr 1fr", gap: "2rem", alignItems: "center" }}>
  <div>
    A [Space](/docs/spaces/overview) is a project room. It's where your team has conversations, shares docs, maintains standing context, and works with agents — all in one place.

    Create a Space for a launch, a client, or an ongoing team channel. Everything inside becomes context your agents can use.

    <Info>
      One Space per project or workflow keeps things focused and makes your agents more accurate.
    </Info>
  </div>

  <img src="https://mintcdn.com/hopsdocs/6g4tmvgWdeoeLgJC/images/spaces-concept.png?fit=max&auto=format&n=6g4tmvgWdeoeLgJC&q=85&s=4631cb09a86a563915f99f2baab8f1bb" alt="A Hops Space showing chat, agents, and shared context." style={{ width: "100%", borderRadius: "8px" }} width="3018" height="1710" data-path="images/spaces-concept.png" />
</div>

## Agents

<Frame caption="Three kinds of agents in Hops: default Hops, private Personal Assistant, and a Custom Agent.">
  <img src="https://mintcdn.com/hopsdocs/6g4tmvgWdeoeLgJC/images/agents-types.png?fit=max&auto=format&n=6g4tmvgWdeoeLgJC&q=85&s=8a9735714536d1a8db984a9450639ad9" alt="Three kinds of agents in Hops: the default Hops agent, the private Personal Assistant, and a Custom Agent (Legal helper)." width="2461" height="894" data-path="images/agents-types.png" />
</Frame>

Agents are the AI members of your team. They live inside your Spaces, respond when you tag them with `@`, and use your team's actual context to get work done.

* **Default agent (`@Hops`)** — available in every Space, no setup needed. Uses admin-added connections plus your personal connections.
* **Custom agents** — built for specific roles with their own instructions and connections. Tag with `@[name]`.
* **Personal agent** — private to you, reads only your personal connections.

A Space can have multiple agents. Tag different ones in the same thread and each responds from its own specialization.

See [Agents](/docs/agents/overview) for the full picture.

## Shared context

<div style={{ display: "grid", gridTemplateColumns: "1fr 1fr", gap: "2rem", alignItems: "center" }}>
  <div>
    Your agents remember. Every conversation, every doc, and every connected tool adds to a Space's shared context. The next question already has the background — nobody re-explains the project.

    Context comes from:

    * The **Space Context** document — a pinned brief agents always read
    * Conversations in your Spaces
    * Docs, files, and artifacts shared with the team
    * Tools you've connected (Slack, Drive, Salesforce, etc.)
    * Previous decisions and work

    <Tip>
      Set up **Space Context** early — it's the fastest way to make every agent in the Space sharper.
    </Tip>
  </div>

  <img src="https://mintcdn.com/hopsdocs/6g4tmvgWdeoeLgJC/images/space-context-panel.png?fit=max&auto=format&n=6g4tmvgWdeoeLgJC&q=85&s=6b23394ae842439a5cbd0ba8f2d8f66d" alt="A Space's About panel highlighting the Space Context section where you set the shared context document." style={{ width: "100%", borderRadius: "8px" }} width="1020" height="1412" data-path="images/space-context-panel.png" />
</div>

## Connected tools

<div style={{ display: "grid", gridTemplateColumns: "1fr 1fr", gap: "2rem", alignItems: "center" }}>
  <div>
    Hops [connects to 2,000+ apps](/docs/connections/overview) via the Pipedream catalog. Once a tool is connected, agents can read from it instead of you copy-pasting.

    * The default `@Hops` agent uses admin-added connections plus your personal connections.
    * Custom agents get their own connections.
    * Your personal agent uses only your personal connections.
  </div>

  <img src="https://mintcdn.com/hopsdocs/6g4tmvgWdeoeLgJC/images/connect-personal-app.png?fit=max&auto=format&n=6g4tmvgWdeoeLgJC&q=85&s=15eb85244b8dbb38558ba73121118f8b" alt="The Connect personal app modal showing Amplitude, Google Drive, Jira, Notion, Slack, Stripe and more." style={{ width: "100%", borderRadius: "8px" }} width="1788" height="1470" data-path="images/connect-personal-app.png" />
</div>

## Search

<div style={{ display: "grid", gridTemplateColumns: "1fr 1fr", gap: "2rem", alignItems: "center" }}>
  <div>
    One search covers your whole workspace. Click the **Search** icon at the bottom of the left sidebar (or press <kbd>⌘</kbd> <kbd>K</kbd>).

    You'll find Spaces, docs, files, tables, and messages you have access to. Filter by **From**, **In**, **Type**, or **Shared with**, and sort by relevance or recency.

    <Tip>
      Search is scoped to what you can access. Private Spaces you're not in won't appear.
    </Tip>
  </div>

  <img src="https://mintcdn.com/hopsdocs/6g4tmvgWdeoeLgJC/images/search-modal.png?fit=max&auto=format&n=6g4tmvgWdeoeLgJC&q=85&s=234d88d5ee5835b9f2fbb2fbc2c06f1e" alt="The Hops search modal with filters (From, In, Type, Shared with) and recent results across Spaces, threads, and agent chats." style={{ width: "100%", borderRadius: "8px" }} width="1596" height="1020" data-path="images/search-modal.png" />
</div>

## Activity

<div style={{ display: "grid", gridTemplateColumns: "1fr 1fr", gap: "2rem", alignItems: "center" }}>
  <div>
    The **Activity** tab in the left sidebar is your unified inbox. Every notification lands here — @mentions, thread replies, agent updates, and Personal Assistant nudges — so you don't have to scan each Space.

    * **Click** any entry to jump into the source thread.
    * **Filter** to narrow to mentions, replies, or a specific update type.
    * **Mark all as read** with the double-check icon.
  </div>

  <img src="https://mintcdn.com/hopsdocs/6g4tmvgWdeoeLgJC/images/activity-feed.png?fit=max&auto=format&n=6g4tmvgWdeoeLgJC&q=85&s=e15829dcd6b46980809b9d0fdc2904b7" alt="The Activity feed showing @mentions, replies, and agent updates from across the workspace." style={{ width: "100%", borderRadius: "8px" }} width="958" height="1722" data-path="images/activity-feed.png" />
</div>

## Visible work and control

Every agent response shows what it used and what it did. Anything with real-world consequences (sending an email, updating a record) asks for your approval first.

## What's next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/docs/quickstart">
    Create your first agent in under five minutes.
  </Card>

  <Card title="Spaces" icon="grid-2" href="/docs/spaces/overview">
    How Spaces organize your team's work.
  </Card>

  <Card title="Agents" icon="user-robot" href="/docs/agents/overview">
    How agents work in Hops.
  </Card>

  <Card title="Connect your tools" icon="plug" href="/docs/connections/overview">
    Plug in the tools your team already uses.
  </Card>
</CardGroup>
