Set up Membral

Claude Code users: install the plugin. Other harnesses, or no plugin: install the CLI. The Chrome extension syncs ChatGPT and Claude.ai chats.

1. Claude Code plugin

Needs Node 22.5 or newer on your PATH. The plugin hooks run Node, and without it every session shows a hook error.

  1. Sign in to your Membral server (an existing account, or your local one), then open Settings, Keys and click Generate API Key. Copy the key.

  2. Inside Claude Code, add the marketplace:

    /plugin marketplace add surajtripathy07/membral-plugin

  3. Install the plugin. It asks for your API key and masks it:

    /plugin install membral@membral

Or from your shell

claude plugin marketplace add surajtripathy07/membral-plugin
claude plugin install membral@membral --config api_key=<your key>

This form leaves your key in your shell history.

What happens next

  • On your first session, the last 30 days of Claude Code and opencode sessions import in the background.
  • Every session is saved when it ends, including sessions you end with ctrl+c.
  • If a session's upload fails, the plugin catches up once a day.
  • Your agent can call memory_search and memory_recall.

2. Chrome extension

Syncs your ChatGPT and Claude.ai conversations into Membral automatically.

Not on the Chrome Web Store — load it unpacked instead; it takes under a minute.

Download membral-extension.zip
  1. 1

    Download the zip above and unzip it somewhere you'll keep it (it needs to stay put — Chrome loads it from that folder).

  2. 2

    Open Chrome's extensions page and turn on Developer mode (top right)

    chrome://extensions
  3. 3

    Click Load unpacked and select the unzipped folder.

  4. 4

    Click the Membral icon, sign in with the same account you use here. The cloud URL is already preset to this site — nothing to configure.

3. Command-line tool

Use this for opencode, Copilot, Codex, or Claude Code without the plugin. Setup finds the harnesses on your machine and wires hooks and MCP for each.

npm i -g https://membral.me/membral-cli.tgz && membral setup

What happens next

  1. Your browser opens so you can approve this device.
  2. Setup scans this machine for Claude Code, Codex, opencode and Copilot CLI sessions and asks what to sync.
  3. Session hooks are installed for the coding harnesses it finds.
  4. Your agent is connected to Membral over MCP.
  5. Your existing sessions are imported.

To check it worked, run membral status. To update later, run the install command again.

GitHub Copilot

  • Plain membral setup covers Copilot CLI and VS Code in every repo: hooks, the MCP server and a short instructions file.
  • Optional: membral setup --copilot inside a repo also commits .vscode/mcp.json and .github/copilot-instructions.md for teammates.

Codex CLI

  • Plain membral setup writes the Membral MCP server into ~/.codex/config.toml (no key in the file), a SessionStart hook for the preamble, and a short marked block in ~/.codex/AGENTS.md that tells Codex to call memory_search first.
  • Codex asks you to approve the hook once. Until you do, the AGENTS.md rule still gives recall.

opencode

  • The plugin injects the preamble into the system prompt at session start.

4. MCP (Claude Desktop, Claude Code, Cursor)

Lets an AI assistant search and read your synced conversations directly, instead of you copy-pasting context by hand. Fully self-service, no build step:

  1. Sign in and open Settings.
  2. Under API Key, click Generate API Key.
  3. Copy the MCP config snippet for your client and paste it into that app's config file.

Search and conversation tools work right away. The identity/context tools that read extracted memories stay empty until memory extraction is enabled for your account — email support@membral.me to ask.