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

# Memory Canvas

> A graph view of what Repo knows — entities, relationships, and source channels.

The memory canvas is a structured snapshot of your org's memory, surfaced as nodes (entities) and edges (relationships). It powers the **Memory** screen in the console and is useful for agents that need to reason about the *shape* of available context, not just retrieve text.

## Required action

`memory:read`

## Query parameters

<ParamField query="limit" type="integer" default="80">
  Max number of nodes to return. Min 10, max 120.
</ParamField>

## Response

```json theme={null}
{
  "nodes": [
    { "id": "memory", "kind": "core", "label": "memory", "count": 142 },
    { "id": "channel:C0123", "kind": "channel", "label": "#brand", "count": 38 },
    { "id": "entity:project:brand-refresh", "kind": "project", "label": "Brand refresh", "count": 12 },
    { "id": "entity:person:sam-rivera", "kind": "person", "label": "Sam Rivera", "count": 9 }
  ],
  "edges": [
    { "from": "memory", "to": "channel:C0123", "kind": "contains" },
    { "from": "channel:C0123", "to": "entity:project:brand-refresh", "kind": "mentions" }
  ]
}
```

<ResponseField name="nodes" type="array">
  Entities Repo has recognized + grouping nodes (channels, workspaces).

  <Expandable title="Node fields">
    <ResponseField name="id" type="string">Stable node ID.</ResponseField>
    <ResponseField name="kind" type="string">`core`, `channel`, `project`, `person`, `customer`, `decision`, `document`, `tool`.</ResponseField>
    <ResponseField name="label" type="string">Display name.</ResponseField>
    <ResponseField name="count" type="integer">How many source items reference this entity.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="edges" type="array">
  Relationships between nodes. Edge `kind` is `contains`, `mentions`, or `from_channel`.
</ResponseField>

## When to use this

* Onboard a new agent by giving it a map of "what does this company even talk about?"
* Build a UI that lets users browse memory by topic instead of search
* Surface "you might also want to ask about..." suggestions