Quickstart

Connect your first AI agent to Tvix in a few minutes. Get persistent memory across sessions via hosted MCP or the OpenClaw plugin.

Give your AI agent persistent memory. Follow the steps below, or use the guided Agents → + Add Agent flow in the dashboard for copy-paste config.

3-Step Guide

Step 1: Create Your Account

Go to tvix.ai (or your local dashboard at http://localhost:3000) and sign in.

For local development, see the repo README — demo user is typically engineer@example.com when auth is disabled.

Step 2: Connect Your Agent

From the dashboard, go to Agents and click + Add Agent, then pick your client. The wizard generates an agent token and shows the config to paste.

Production MCP URL:

https://api.tvix.ai/mcp

Locally / Tvix for Mac, Bearer clients use http://127.0.0.1:8000/mcp (not api.tvix.ai). ChatGPT and Poke need a public HTTPS URL — on Mac, tap Enable remote agents in the wizard.

Most clients use Bearer auth with the token from the wizard. ChatGPT and Poke use OAuth. OpenClaw uses the in-repo plugin (no MCP Bearer token).

Cursor / VS Code / Gemini / OpenCode

Paste the JSON MCP config from the Agents wizard into your client's MCP settings. Example shape:

```json
{
  "mcpServers": {
    "tvix": {
      "url": "https://api.tvix.ai/mcp",
      "headers": {
        "Authorization": "Bearer <your-agent-token>"
      }
    }
  }
}
```

Then reload MCP servers / the window.

Claude Desktop

Paste the Claude Desktop config from the wizard (`npx mcp-remote` + Bearer header — Desktop does not accept bare `url` + `headers`), then restart Claude Desktop. Requires Node 20.18.1+.

Claude Code

Use the command from the Agents wizard, for example:

```bash
claude mcp add tvix --url https://api.tvix.ai/mcp --header "Authorization: Bearer <your-agent-token>"
```

Then verify with a memory search query in Claude Code.

ChatGPT

Use **Agents → ChatGPT**. On production, paste `https://api.tvix.ai/mcp` with **OAuth**. On Tvix for Mac / local, tap **Enable remote agents**, then copy the HTTPS URL.

Codex / Hermes / Poke

Add a remote MCP server with the MCP URL and Bearer token (or OAuth for Poke) from the Agents wizard.

OpenClaw

This repo ships an OpenClaw plugin (`openclaw/plugins/execution-twin`, plugin id `execution-twin`). From the Agents wizard, copy the plugin config (`apiUrl` + `userEmail`; optional `serviceToken` when API auth is on), enable the plugin, and restart the OpenClaw gateway. This path does not use `/mcp`.

See [OpenClaw](/connectors/openclaw) for details.

MCP URL

For any MCP-compatible client:

```
https://api.tvix.ai/mcp
```

Auth: Bearer agent token (or OAuth where supported).

Tip: For detailed steps, see Cursor, Claude Desktop, ChatGPT, OpenClaw, Tvix for Mac, and Hermes.

Step 3: Start Using Memory

Once connected, your agent can read from and write to Tvix.

Saving memory (capture_memory)

Tell your agent something worth remembering. Your agent calls capture_memory to store it.

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.

Retrieving memory (search_memory)

When context would help, your agent calls search_memory.

Set up a new project for me.

The agent can also write and search Wiki via create_wiki_note and search_wiki. Memory is for personal/work episodes; Wiki is for Knowledge Atlas notes and reference material. See Tvix MCP and Knowledge Wiki.

Check: You're all set! Your agent now has persistent memory powered by Tvix.

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

Knowledge Atlas notes, projects, resources, and inbox.

All Agents

Full setup guides for supported clients.