MemoraX Code

Make Every Interaction the Starting Point for the Next

Coding agents are good at the task in front of them, but a new session often starts without the architecture, failed attempts, repository rules, or working preferences established before it.

MemoraX Code gives Codex, Claude Code, CodeBuddy CLI, WorkBuddy, DeepSeek Harness, OpenCode, Trae, Cursor, and Qoder a shared memory layer for that context. It can recall prior engineering knowledge, capture reusable lessons from completed work, maintain repository knowledge, and carry your procedures and preferences into future sessions.

The goal is not to remember everything. It is to bring back the small amount of memory relevant to the current task so the agent can reach useful investigation and validation sooner.

Quick Start

Prepare Node.js 20+ (Node.js 24 LTS recommended) and at least one of Codex, Claude Code, CodeBuddy CLI, WorkBuddy, DeepSeek Harness, OpenCode, Trae, Cursor, or Qoder.

For DeepSeek Harness (DSH), current releases require Node.js ^22.19.0 || >=24.0.0. Install or initialize DSH first, create at least one Profile, and ensure pnpm is on PATH for npm CLI installations before running setup. For DSH Desktop, open it once to initialize its Profile, then fully quit it for plugin installation; MemoraX Code uses its bundled launcher and package manager. CLI and Desktop can be enabled together. MemoraX Code does not install or update DSH.

On Linux, guest credentials require /usr/bin/secret-tool from libsecret and an available Secret Service in the current user session. For Remote SSH, WSL, or Dev Containers, install MemoraX Code in the same environment as the coding agent. MemoraX search and writeback require network access.

Install and Connect

1. Install the Package

npm install -g @memorax/memorax-code

This installs the package; it does not start interactive setup. Do not use --ignore-scripts: npm lifecycle scripts safely stop and restore an existing running managed Backend during package replacement.

2. Connect a MemoraX Account (Recommended)

Create a MemoraX account or use an existing one, then run from a normal interactive terminal:

memorax-code setup --existing-account

Follow the setup prompts to enter your MemoraX username and API key locally.

For a coding agent without an interactive terminal, pass the API key through stdin. The examples assume MEMORAX_SETUP_API_KEY is already provided by the caller. Do not put the key in command arguments or project files.

printf '%s\n' "$MEMORAX_SETUP_API_KEY" | memorax-code setup --existing-account --non-interactive

In Windows PowerShell:

$env:MEMORAX_SETUP_API_KEY | memorax-code.cmd setup --existing-account --non-interactive

This explicit command replaces the saved key and uses the detected local username and system language. It reports API Key match: true after local configuration and readiness checks; this does not verify cloud credentials. See non-interactive setup for input and reuse behavior.

[!TIP] Using MemoraX Code across devices? Find the username and API key in the configuration file on a configured device (normally ~/.memorax-code/config.toml), then enter them in the local setup terminal on the new device. This file contains your API key; keep it private and never paste it into chats or public issues.

Or Try Without an Account (90-Day Guest Mode)

To start immediately and connect an account later, run:

memorax-code setup

Default setup reuses a complete existing connection. Otherwise, it detects your local username and language, asks when needed, and creates or restores guest credentials. To replace the saved connection, use memorax-code setup --reconfigure for guest mode or memorax-code setup --existing-account for a registered account.

To keep your guest memory when registering later, first run this command directly in your local terminal:

memorax-code account --show-mark-id

[!IMPORTANT] Obtain the Mark ID before registering, then use it to activate your guest account on MemoraX. The platform does not currently support attaching a Mark ID to an account that has already been registered.

3. Activate and Verify

Both setup paths automatically detect supported coding agents. Restart or refresh every detected coding agent after setup. While the managed Backend is running, an agent you install later is enabled within about 15 minutes; see Clients installed after setup to exclude one.

Client	Complete activation
Codex	Enable MemoraX Code Codex Adapter from Plugins or /plugins if it is not already enabled.
Claude Code	Restart or refresh the client to load the managed plugin and Hooks.
CodeBuddy CLI	Start a new CLI session to load the managed plugin, Hooks, and Skill.
WorkBuddy	Restart WorkBuddy to load its independently managed plugin, Hooks, and Skill.
DeepSeek Harness	Restart or refresh DSH to load the plugin registered in existing Profiles.
OpenCode	Restart or refresh the client to discover the managed plugin and Skill.
Trae	In Settings → Hooks → Global → Configured Hooks, enable the registered Global Hooks once. Setup installs the Hooks and Skill; this switch requires manual activation.
Cursor	Restart or refresh Cursor, then open a new conversation to load its native user Hooks, shared Skill, and managed background subagent.
Qoder	Restart Qoder and start a new task to load the managed user Hooks, shared Skill, and background subagent.

This is the beginning of the README. Read the rest at the original. Read the full README ↗