Vault

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.

The Vault is your home in xysq. Every memory an agent has stored for you, every document you’ve added to your knowledge base, 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.

​

Scope: what you’re looking at

The Vault always shows exactly one bank at a time. Pick which one from the scope dropdown in the toolbar: The four “Main” / Knowledge Base scopes are visible in your personal vault. The two Team scopes show up when you’re inside a team vault (/teams/:teamId/vault). xysq never draws connections across banks — by design, your personal memory stays isolated from teams you’re in.

​

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.

​

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: 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

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 banks you own or are a member of. Confidential and PII banks are personal-only — they never surface in team vaults, and team memory never bleeds into your personal main. The graph respects the same isolation: cross-bank edges are never drawn.