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

# What is a "Context Repository"?

> What the context repository is and how it works

## Overview

Your **context repository** is the structured company context Qontext builds for your workspace.

It contains normalized Markdown files organized in a folder tree, for example customers, employees, products, projects, and processes. Each file captures shared context about one entity or topic and can reference source objects and related files.

Each workspace has one context repository. It updates continuously as connected sources change.

***

## What a context repository looks like

The context repository is organized as files and folders. Each file contains structured facts, relationships, source references, and metadata extracted from your connected sources.

Example structure:

<Tree>
  <Tree.Folder name="Workspace" defaultOpen>
    <Tree.Folder name="Customers" defaultOpen>
      <Tree.Folder name="Customer_closed" defaultOpen>
        <Tree.File name="brightline-solutions.md" />

        <Tree.File name="clearwater-logistics.md" />
      </Tree.Folder>

      <Tree.Folder name="Customer_leads" defaultOpen>
        <Tree.File name="redstone-capital.md" />
      </Tree.Folder>

      <Tree.Folder name="Customer_lost" defaultOpen>
        <Tree.File name="foxwood-media.md" />
      </Tree.Folder>
    </Tree.Folder>

    <Tree.Folder name="Employees" defaultOpen>
      <Tree.File name="amara-diallo.md" />

      <Tree.File name="jonas-becker.md" />
    </Tree.Folder>

    <Tree.Folder name="Products" defaultOpen>
      <Tree.File name="digital-transformation-advisory.md" />

      <Tree.File name="managed-operations.md" />
    </Tree.Folder>

    <Tree.Folder name="Projects" defaultOpen>
      <Tree.File name="crm-migration-salesforce.md" />

      <Tree.File name="emea-market-expansion.md" />
    </Tree.Folder>
  </Tree.Folder>
</Tree>

When your repository is first created, Qontext proposes a folder structure based on your connected sources.

You can review and adjust the folder structure before it is finalized and alter it anytime.

You can edit files and folders manually [via the UI](/context-repository/ui) or [via MCP](/context-repository/MCP), and Qontext can continue updating them as source data changes.

***

## How the context repository is built and updated

<div className="qontext-cards">
  <CardGroup cols={3}>
    <Card title="Entity extraction" icon="circle-nodes">
      Detects key entities like people, companies, and concepts.
    </Card>

    <Card title="Relationship mapping" icon="code-branch">
      Connects related entities across your data sources.
    </Card>

    <Card title="Graph construction" icon="screwdriver-wrench">
      Builds a context graph that reflects real-world relationships.
    </Card>
  </CardGroup>

  <CardGroup cols={1}>
    <Card title="Continuous updates" icon="rotate">
      Keeps your context current as connected sources change.
    </Card>
  </CardGroup>
</div>

***

## Why the context repository matters

* **One shared context layer:** Store company context once and expose it consistently to agents, MCP clients, APIs, and workflows.
* **Agent-readable structure:** Provide agents files, folders, references, and metadata instead of fragmented source data.
* **Relationship-aware retrieval:** Let agents follow connected context instead of relying on isolated search results.
* **Governance:** Control which users and clients can access which context.
* **Operational reliability:** Reduce duplicated, stale, or conflicting context across tools.

***

## FAQ

<AccordionGroup>
  <Accordion title="How long does the initial build take?">
    It depends on data volume. Small workspaces typically complete in minutes; large ones with many sources can take more time .
  </Accordion>

  <Accordion title="Can I edit files in the repository manually?">
    Yes. You can browse and edit any file in the context repository from the [Qontext app](app.qontext.ai). See [here](/context-repository/ui) for details.
  </Accordion>
</AccordionGroup>