Tvix
SupportGo to Dashboard

Claude Code

Connect Tvix to Claude Code with the Tvix Claude Code plugin. Add persistent memory, wiki retrieval, slash commands, hooks, and project-aware context to your coding sessions.

The Tvix Claude Code plugin is the recommended way to use Tvix in Claude Code. It runs locally with Claude Code, connects to your Tvix Cloud account through OAuth, and exposes memory and wiki workflows through both slash commands and MCP tools.

Install the Tvix Claude Code plugin

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

Load the plugin in Claude Code

Open Claude Code. If Claude Code is already open, run:

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

Connect your Tvix account

In Claude Code, run:

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

The login flow opens browser OAuth and asks you to choose an auto-capture mode:

* `wiki`: enable Wiki auto-capture for user/assistant conversation transcripts
* `off`: disable hook-based auto-capture

Verify the connection

Run:

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

Confirm the connected account before saving memory or wiki data.

What the Plugin Adds

  • Slash commands: /tvix:login, /tvix:status, /tvix:recall, /tvix:remember, /tvix:wiki, /tvix:index-project, and /tvix:project-config
  • Automatic recall: Searches Tvix before prompts when auto-recall is enabled and injects relevant context as untrusted reference data
  • Wiki retrieval: Lets Claude Code search, add, update, and delete factual wiki documents through Tvix tools
  • Hooks: Supports session start context, prompt-time recall, and opt-in Wiki capture for durable conversation source material
  • Project-aware workflows: Can scope memories to the current git repository when project mode is enabled
  • Local credential storage: OAuth tokens are stored in Claude Code's plugin data directory, not in plugin user settings

Tip: Auto-capture only controls hook-based capture. Claude can still write memories or Wiki docs through Tvix tools when appropriate.

Auto-Capture Privacy

Auto-capture is opt-in during /tvix:login. Wiki capture stores the user/assistant conversation transcript as original source material in Tvix Wiki, not as extracted Memory.

The plugin redacts secrets, .env values, private key blocks, and content wrapped in <private> or <tvix-private> before capture.

Session Start Context

Session start context (sessionStartContext) is separate from auto-capture. When configured, the plugin can provide relevant Tvix context at the beginning of a Claude Code session so Claude starts with project background before your first prompt.

That context is read-only reference material. It does not write new memories or Wiki documents by itself, and Claude should treat retrieved content as untrusted context that still needs user intent before taking action.

MCP Fallback

If Claude Code plugins are not available in your environment, you can still connect Tvix as a standard MCP server:

npx -y tvix@latest --client claude-code

The MCP fallback provides the core memory and wiki tools, but it does not include Claude Code plugin slash commands, hooks, or project-aware workflows.

Troubleshooting

Claude Code does not show Tvix commands

Run `/reload-plugins` inside Claude Code. If the commands still do not appear, run `claude plugin marketplace add aristoapp/claude-tvix && claude plugin install tvix@tvix-plugins` again and start a new Claude Code session.

I connected the wrong Tvix account

Run `/tvix:logout`, then `/tvix:login` and verify the account with `/tvix:status`. For the cleanest context after switching accounts, run `/clear` or start a new Claude Code session.

I already have the old Tvix MCP setup installed

Keep the Claude Code plugin as the primary path. You can leave the remote MCP setup as a fallback, but if duplicate tools are confusing, remove the older MCP configuration after confirming the plugin works.

Next Steps

Bring Your Context

Import chat history, connect apps, and more.

Use Your Context

Chat with Memory, agent retrieval, and dashboard exploration.

Knowledge Wiki

Store factual knowledge alongside your memories.

Tvix MCP

See every MCP tool your agent can call.
Was this page helpful?