> ## Documentation Index
> Fetch the complete documentation index at: https://supermemory-capy-add-llmstxt-summary-and.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Supermemory

> The full loop: authenticate, put context in, get it back out, keep it correct.

export const JourneyItem = ({icon, title, href}) => <a href={href} className="group flex items-center gap-2.5 rounded-lg border border-gray-200 dark:border-zinc-800 bg-white dark:bg-zinc-900/40 px-3.5 py-2.5 no-underline text-[13px] font-medium text-gray-700 dark:text-zinc-300 transition-colors duration-150 hover:border-gray-300 dark:hover:border-zinc-600 hover:bg-gray-50 dark:hover:bg-zinc-800/60 hover:text-gray-900 dark:hover:text-zinc-50">
    {icon && <Icon icon={icon} className="h-3.5 w-3.5 shrink-0 text-gray-400 dark:text-zinc-500 group-hover:text-gray-600 dark:group-hover:text-zinc-300" />}
    {title}
  </a>;

export const JourneyStep = ({number, title, children}) => <div className="relative pl-10">
    <div className="absolute left-0 top-0 flex h-7 w-7 items-center justify-center rounded-full border border-gray-200 dark:border-zinc-700 bg-gray-50 dark:bg-zinc-900 text-sm font-semibold text-gray-700 dark:text-zinc-300">
      {number}
    </div>
    <h3 className="mb-3 text-base font-semibold text-gray-900 dark:text-zinc-50">
      {title}
    </h3>
    <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2.5">
      {children}
    </div>
  </div>;

export const Journey = ({children}) => <div className="not-prose relative my-8 flex flex-col gap-9">
    <div className="absolute left-[13px] top-3 bottom-3 w-px bg-gray-200 dark:bg-zinc-800" />
    {children}
  </div>;

Everything in this section is one of four steps. Same loop whether you're building personal memory, RAG over docs, or both on the same `containerTag`.

<Journey>
  <JourneyStep number="1" title="Get started">
    <JourneyItem icon="/icons/hugeicons/play.svg" title="Quickstart" href="/quickstart" />

    <JourneyItem icon="/icons/hugeicons/key-01.svg" title="Get an API key" href="/authentication" />

    <JourneyItem icon="/icons/hugeicons/book-open-01.svg" title="API Reference" href="/api-reference/overview" />
  </JourneyStep>

  <JourneyStep number="2" title="Ingest — get content in">
    <JourneyItem icon="/icons/hugeicons/plus-sign.svg" title="Add memories & documents" href="/ingestion/add-memories" />

    <JourneyItem icon="/icons/hugeicons/clock-01.svg" title="Backfill historical data" href="/ingestion/batch-ingest-historical-data" />

    <JourneyItem icon="/icons/hugeicons/files-02.svg" title="Document operations" href="/ingestion/document-operations" />

    <JourneyItem icon="/icons/hugeicons/plug-01.svg" title="Connectors" href="/connectors/overview" />

    <JourneyItem icon="/icons/hugeicons/files-01.svg" title="Content types" href="/concepts/content-types" />

    <JourneyItem icon="/icons/hugeicons/command-line.svg" title="Ingest API reference" href="/api-reference/ingest" />
  </JourneyStep>

  <JourneyStep number="3" title="Retrieve — get context back out">
    <JourneyItem icon="/icons/hugeicons/search-01.svg" title="Search" href="/recall/search" />

    <JourneyItem icon="/icons/hugeicons/user.svg" title="User profiles" href="/recall/user-profiles" />

    <JourneyItem icon="/icons/hugeicons/database-01.svg" title="SMFS" href="/smfs/overview" />

    <JourneyItem icon="/icons/hugeicons/command-line.svg" title="Recall API reference" href="/api-reference/search" />
  </JourneyStep>

  <JourneyStep number="4" title="Manage">
    <JourneyItem icon="/icons/hugeicons/eraser-01.svg" title="CRUD & forgetting" href="/recall/memory-operations" />

    <JourneyItem icon="/icons/hugeicons/check-list.svg" title="Review inferred memories" href="/recall/memory-review" />

    <JourneyItem icon="/icons/hugeicons/settings-02.svg" title="Customizing behavior" href="/concepts/customization" />

    <JourneyItem icon="/icons/hugeicons/justice-scale-01.svg" title="Rules of thumb" href="/concepts/rules" />

    <JourneyItem icon="/icons/hugeicons/command-line.svg" title="Memories API reference" href="/api-reference/memories" />

    <JourneyItem icon="/icons/hugeicons/test-tube-01.svg" title="Benchmark it yourself" href="/memorybench/overview" />
  </JourneyStep>
</Journey>

Raw input automatically becomes memories (the knowledge graph) and indexed document chunks (for RAG). You don't choose one or the other; both come from the same write. Retrieval then gives you three ways to read that pool back. If you're unsure which fits, read [Memory vs RAG](/concepts/memory-vs-rag).

## Where next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/play.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=fbac7fd9d974ea65e013c203efb289a2" href="/quickstart" width="24" height="24" data-path="icons/hugeicons/play.svg">
    Walk the whole loop end to end with one working example.
  </Card>

  <Card title="How it works" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/cpu.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=b669601f6ec83ecf1a69938702040556" href="/concepts/how-it-works" width="24" height="24" data-path="icons/hugeicons/cpu.svg">
    What happens between `add()` and a memory showing up in search.
  </Card>

  <Card title="Container tags" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/folder-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=d533387aff4328cae4e17d17fdb1674f" href="/concepts/container-tags" width="24" height="24" data-path="icons/hugeicons/folder-01.svg">
    The isolation boundary every ingest and retrieve call is scoped to.
  </Card>

  <Card title="Memory vs RAG" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/balance-scale.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=41d6eec40b7dd88ae9d7bbceb21f92de" href="/concepts/memory-vs-rag" width="24" height="24" data-path="icons/hugeicons/balance-scale.svg">
    When to reach for search, profiles, or both.
  </Card>

  <Card title="Benchmarking" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/test-tube-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=6ea50f02549a743d9edd079782db4ee6" href="/memorybench/overview" width="24" height="24" data-path="icons/hugeicons/test-tube-01.svg">
    Run standardized, reproducible evals against Supermemory and other providers — including your own.
  </Card>
</CardGroup>


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