How Tvix Works
How context flows into Tvix's two knowledge stores (Memory and Wiki), gets structured, and comes back to your agents.
Tvix transforms raw context into structured, searchable knowledge that your agents can pull from across sessions.
Architecture Overview
Tvix keeps two complementary knowledge stores. Agents can read and write both through MCP, and Chat in Dashboard can consult both when stored context helps.
| Memory | Wiki | |
|---|---|---|
| What it stores | Personal/work episodes: preferences, decisions, meetings, emails | Knowledge Atlas notes, projects, resources, inbox |
| How it's structured | Memories + graph relationships | Workspace overview (projects / notes / resources / inbox) |
| Primary input | capture_memory, Chat, paste imports, app sync | Dashboard Wiki UI, create_wiki_note, markdown paste, Notion sync |
| Primary retrieval | search_memory, Chat, Memories views | search_wiki, Chat, Wiki overview |
Context flows through ingest → process → retrieve.
1. Context to Tvix
Memory
- Paste import — ChatGPT / Claude / Gemini text on Sources.
- Live agent — Agent calls
capture_memoryvia MCP. - Chat — Dashboard chat can capture durable context.
- Integrations — Slack, Google Workspace, GitHub, Notion sync when connected.
Wiki
- Write in dashboard — Create notes and projects on the Wiki page.
- Agent —
create_wiki_notewith a title and optional content. - Markdown paste — Obsidian / Markdown card on Sources.
- Notion — OAuth connector when configured.
- Inbox triage — Review captures before they become durable notes.
2. Digesting and Structure
Memory
Incoming text and synced artifacts go through ingestion pipelines: storage, optional LLM extraction, embeddings for hybrid search, and graph-oriented views in the dashboard.
Wiki
Notes and projects live in the Wiki / Knowledge Atlas APIs (/api/v1/workspace/*). Inbox items can be triaged. Search is exposed to agents via search_wiki.
3. Tvix to Your Agent
- Agent (or Chat) calls
search_memoryand/orsearch_wiki. - Tvix returns ranked results with citations where available.
- The agent answers using that context — without you repeating yourself.
Write tools (capture_memory, create_wiki_note, draft_follow_up, …) may require human approval when used from dashboard agent mode.
Next Steps
Attached vs Universal
Why shared memory matters.
Tvix MCP
MCP tools available to your agents.
Memory
Memory exploration and management.
Knowledge Wiki
Knowledge Atlas notes, projects, and inbox.