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

# Introduction

> Hosted memory for AI agents. Send conversation turns, get back searchable facts.

**XTrace Memory Manager** is a hosted memory service for AI agents. You send conversation messages; we extract structured **facts**, **artifacts**, and **episodes** from them, embed each one, and store them in a per-org vector index. You retrieve them later with natural-language search — scoped to a single user, or shared across a **group**.

## Concepts in 30 seconds

| Term         | What it is                                                                                                                                        |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fact**     | A single semantic claim extracted from a conversation turn (e.g. *"User is vegetarian"*). Most ingested memory is facts.                          |
| **Artifact** | A structured object referenced by the conversation (e.g. a doc, code snippet, summary). Server-extracted when content warrants it.                |
| **Episode**  | A session-scoped summary spanning a stretch of turns. Bounds the temporal scope of facts.                                                         |
| **Memory**   | Umbrella term — every Fact / Artifact / Episode is a Memory, distinguished by its `type` field.                                                   |
| **Group**    | A shared tagging target. Tag memories to a group at ingest, and every member can search them — memory shared *across users*, not just within one. |

You don't have to pre-classify anything when you ingest. The server decides what becomes a fact vs an artifact vs an episode.

## Five-minute path

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/guides/quickstart">
    Install the SDK, ingest a turn, search the result
  </Card>

  <Card title="Authentication" icon="key" href="/guides/authentication">
    API keys, org headers, environment setup
  </Card>

  <Card title="Ingesting memories" icon="upload" href="/guides/ingesting-memories">
    Async vs sync ingest, polling for completion
  </Card>

  <Card title="Searching memories" icon="magnifying-glass" href="/guides/searching-memories">
    Scope by user, group, agent, or app — plus `recall`
  </Card>

  <Card title="Groups" icon="users" href="/guides/groups">
    Share memory across users with group tagging
  </Card>
</CardGroup>

For the full endpoint and type reference, see the **API Reference** tab.

<Note>
  The TypeScript SDK ([@xtraceai/memory](https://www.npmjs.com/package/@xtraceai/memory)) is the primary supported client today. A Python SDK is on the roadmap. All examples below use the TS SDK; the underlying HTTP API is documented in the **API Reference** tab if you need to wire something yourself.
</Note>