Quickstart

Connect your first AI agent to Tvix in 3 simple steps. Get persistent memory across sessions in under 5 minutes with one-click or CLI setup.

Give your AI agent persistent memory in just a few minutes. Watch the video for a quick overview, or jump straight to the step-by-step guide below.

How to Start

Watch a quick walkthrough to see the full setup in action.

3-Step Guide

Follow these steps to connect your first AI agent to Tvix.

Step 1: Create Your Account

Go to app.membase.so and create your account.

Tip: Tvix is currently in open beta. Anyone can create an account and start using it while we continue improving the product.

Step 2: Connect Your Agent

From the dashboard, go to the Agents tab and click + Add Agent, then pick your client.

Most agents connect with a single command or one-click setup. Some plugin-based clients ask you to run a login command inside the agent after installation.

Cursor

Click **"Add to Cursor"** in the dashboard. Cursor installs Tvix automatically.

ChatGPT

Go to **Settings > Apps > Advanced Settings**, click **Create app**, and enter the MCP URL:

```
https://mcp.membase.so/mcp
```

Claude

Go to [Claude connector settings](https://claude.ai/settings/connectors), click **Add custom connector**, and enter:

```
https://mcp.membase.so/mcp
```

Name the connector `Tvix`, then click **Connect** and complete authentication.

Claude Code

Install the Claude Code plugin:

```bash theme={null}
claude plugin marketplace add aristoapp/claude-tvix && claude plugin install tvix@tvix-plugins
```

If Claude Code is already open, run:

```text theme={null}
/reload-plugins
```

Then connect your Tvix account:

```text theme={null}
/tvix:login
```

Codex

Run this command in your terminal:

```bash theme={null}
npx -y tvix@latest --client codex
```

VS Code

Click **"Add to VS Code"** in the dashboard. VS Code installs Tvix automatically.

Poke

Go to [Integrations](https://poke.com/integrations/new) and add the MCP URL:

```
https://mcp.membase.so/mcp
```

Gemini CLI

Run this command in your terminal:

```bash theme={null}
npx -y tvix@latest --client gemini-cli
```

OpenCode

Run this command in your terminal:

```bash theme={null}
npx -y tvix@latest --client opencode
```

Then authenticate:

```bash theme={null}
opencode mcp auth tvix
```

OpenClaw

Run this command in your terminal:

```bash theme={null}
openclaw plugins install @tvix/openclaw-tvix
```

Then log in:

```bash theme={null}
openclaw tvix login
```

Hermes

Run this command in your terminal:

```bash theme={null}
uv tool install hermes-tvix && hermes-tvix install
```

Requires Python 3.11+. If you prefer `pip`, `pip install hermes-tvix && hermes-tvix install` also works.

MCP URL

For any MCP-compatible client, use the server URL directly:

```
https://mcp.membase.so/mcp
```

Tip: For detailed step-by-step instructions, see the Agents guide for MCP clients, Claude Code for the Claude Code plugin, plus the dedicated plugin pages for OpenClaw and Hermes.

Step 3: Start Using Memory

Once connected, your agent can read from and write to Tvix. There are two core operations: saving memory and retrieving it.

Saving memory (add_memory)

Tell your agent something worth remembering. Your agent calls add_memory to store it in Tvix.

I prefer TypeScript over JavaScript, and I use Bun as my package manager.
My current project is a Next.js app with Supabase for auth.

✓ Saves the conversation as an episode
✓ Extracts entities: TypeScript, Bun, Next.js, Supabase
✓ Links related entities and episodes in your knowledge graph

Retrieving memory (search_memory)

Next time you (or any connected agent) need context, your agent calls search_memory to pull relevant memories.

Set up a new project for me.

✓ Found: "Prefers TypeScript over JavaScript"
✓ Found: "Uses Bun as package manager"
✓ Found: "Current project uses Next.js + Supabase"
→ Agent sets up the project with TypeScript, Bun, and Next.js without you repeating anything.

You don't need to trigger any of this manually. Your agent decides when to save and when to search. Just chat normally.

Tip: The same agent can also write and search factual knowledge via add_wiki and search_wiki. Memory is for personal context; the wiki is for reference material (docs, specs, stable notes). See the Knowledge Wiki guide for details.

Check: You're all set! Your agent now has persistent memory powered by Tvix. Memories are automatically created, updated, and shared as you interact.

Next Steps

Bring Your Context

Import chat history, connect Gmail, Calendar, and Slack.

Use Your Context

Chat with Memory, agent retrieval, and dashboard exploration.

Knowledge Wiki

Store factual knowledge and import Notion, Obsidian, or Markdown files.

All Agents

Full setup guides for all supported clients.