> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xysq.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Vault
> All your memory in one place. Browse it as a table, navigate it as a 3D graph.
The Vault is your home in xysq. Every memory an agent has stored for you, every file you've uploaded in [Organise](/features/organise), every piece of context your AI partners share, it all lives here, and you can move through it two ways:
* **Table view** for searching, filtering, editing tags, and managing individual memories.
* **Graph view** for seeing the shape of what you know — clusters, hubs, and the connections your vault has formed.
Both views read from the same underlying memory and switch with a single toggle in the top right.
Open the Vault at [app.xysq.ai/vault](https://app.xysq.ai/vault). The old `/graph` URL redirects here with the graph view pre-selected.
## Scope: what you're looking at
The Vault shows one vault at a time. Which one depends on where you are:
| Vault | URL | What it holds |
| ---------------- | ---------------------- | ----------------------------------------------------------------------------------------------------- |
| **Personal** | `/vault` | Your own memory: everything agents extract from your conversations, plus what you upload in Organise. |
| **Team** | `/teams/:teamId/vault` | A team you're a member of: the shared memory the whole team recalls from. |
| **Organisation** | `/org/:orgId/vault` | Your work memory inside an organisation, kept separate from your personal vault. |
You move between them by navigating: open a team from the Teams page to land in its vault, or open the personal Vault from the sidebar. Personal, team, and organisation memory stay isolated from each other by design, and the graph never draws connections across them.
### Privacy sub-scope (personal vault)
Inside your personal Vault, a sub-scope chip in the search bar narrows the view by privacy:
| Sub-scope | What it shows |
| ---------------- | ---------------------------------------------------------------------------------------------------------- |
| **Default** | Your everyday memory, with anything marked PII or Confidential held back. |
| **PII** | Only identity-tied facts: contact details, profiles, personal background. PII is never shared with agents. |
| **Confidential** | Only memories you've marked confidential. These are shared with agents only with your consent. |
The sub-scope chip is personal only. It doesn't appear in a team or organisation vault.
## Table view
The default view. A scannable list of every memory in the selected bank, grouped by the document or conversation they came from.
### Search
Type a query and press Enter. The Vault switches from "browse" to "recall" — xysq runs a semantic search against the bank and ranks results by relevance. Hit `×` (or empty the input and press Enter) to go back to browsing.
When a search is active, a sort toggle appears: **Relevance** (default) or **Newest**.
### Filters
* **Tags** — click a tag chip in any row to filter; click again to clear. The Manage Tags drawer (top-right button) lists every tag in your vault and lets you rename or delete tags across all memories at once.
* **Agent** — narrow to memories created by a specific connected agent.
Filters compose with **AND** semantics — every chip you add tightens the result set.
### Editing
Each row has a kebab menu:
* **Edit tags** — toggle curated tags (mood, domain, privacy) or apply tags from your existing taxonomy. Tag creation lives in Manage Tags, not in this menu, so your tag list stays curated.
* **Download** — for memories backed by an uploaded asset (PDFs, images), grab the original file.
* **Retry** — re-run extraction on a memory that failed to index.
* **Delete** — remove the memory from the bank. This deletes the parent document, so every memory unit derived from that document goes with it.
## Graph view
Flip the toggle to **Graph** and the same bank renders as a 3D map. Every memory is a star; every connection between memories is a filament.
The graph is read-only. Nothing you do here mutates the vault — it's purely a navigation lens over the data the Table view shows.
### Nodes and clusters
Memories are coloured by how many entities they reference. This is xysq's own classification — you don't configure it, you just see the shape of it:
| Cluster | Colour | Meaning |
| ----------------- | ---------- | ------------------------------------------------------------------------------------------------ |
| **Multi-entity** | Vivid blue | Memories referencing 2+ named entities — typically the dense, well-connected core of your vault. |
| **Single entity** | Light blue | Memories about one specific person, project, or thing. |
| **No entities** | Grey | Standalone notes — usually short fragments or raw quotes without named subjects. |
The left-panel legend ranks clusters by node count and shows a live tally. Click a cluster name to toggle its visibility — useful for isolating "what do I know about specific entities" vs "what's still drifting unattached".
Entity density turns out to be a surprisingly useful signal: dense regions of multi-entity blue are where your vault has built up rich, cross-referenced context. Sparse grey patches are notes that haven't been connected to anything yet.
### Edges
Three kinds of filaments connect the memories:
* **Semantic** — memories that share topic embeddings (cluster-like). Undirected.
* **Temporal** — same conversation or time window. Directed (older → newer).
* **Entity** — both memories mention the same named entity (e.g. "Vertex AI").
The right-panel Edges legend keys each colour. Edges fade with camera distance so close-up detail stays readable.
### Focusing a memory
Click any star. The camera zooms in to frame that node with its direct neighbours, and a detail drawer opens on the right:
* **Memory text** — full content xysq indexed.
* **Context** — what conversation or document it came from.
* **Entities** — the entity strings that classify this memory.
* **Tags** — labels you or an agent attached.
* **Connections** — every memory directly linked to this one. Click any to jump there without losing the spatial mental model.
Click empty space to clear focus and pull back to the full galaxy.
### Controls
| Control | What it does |
| ----------------- | ----------------------------------- |
| Drag | Orbit around the galaxy |
| Scroll / pinch | Zoom in and out |
| `+` / `−` | Step zoom |
| `⟲` | Reset to fit the whole bank in view |
| Click a node | Zoom in, open the detail drawer |
| Click empty space | Clear focus |
For very large banks (over 3000 memory units), a **Memory limit** slider appears in the bottom-right panel — useful for trimming a noisy graph down to the densest core, or expanding the request when you want to see the whole long tail.
## When to use which view
* **Table** — you're looking for a specific memory, editing tags, cleaning up after a failed extraction, or browsing what an agent stored from a recent session.
* **Graph** — you want the shape of what your vault knows: where the dense clusters are, which entities sit at the centre, which topics you've barely covered. Useful before a planning session, when onboarding a new agent to a domain, or when you suspect there's a memory you've forgotten but can't name.
The view toggle is sticky — the Vault remembers your last choice across sessions.
## Privacy
The Vault is gated by the same Auth0 identity and team membership rules as every other xysq surface. You only see vaults you own or are a member of. Confidential and PII memories are personal only: they never surface in team or organisation vaults, and team memory never bleeds into your personal vault. The graph respects the same isolation, so cross-vault edges are never drawn.