@memorax/memorax-code 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MemoraX AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @memorax/memorax-code
+
+MemoraX Code adds persistent coding memory to Codex and Claude Code.
+
+## Requirements
+
+- Node.js 24 or newer and npm.
+- Codex or Claude Code.
+- A MemoraX account, Base User ID, and API key for memory features.
+- Python 3 only for Repo Memory operations.
+
+## Install
+
+Create an API key in
+[MemoraX Console](https://platform.memorax.net/), then run:
+
+```bash
+npm install -g @memorax/memorax-code --foreground-scripts
+```
+
+Keep `--foreground-scripts` so npm displays the complete setup.
+
+The installer automatically detects the Codex and Claude Code clients available
+on the machine and configures each client it finds. Follow the prompts to enter
+your MemoraX Base User ID, preferred language, and API key. When Codex is
+detected, review and approve its Hook activation.
+
+Entering the MemoraX credentials after the installer's disclosure enables the
+core memory features and automatic writeback. If setup is skipped or cannot
+prompt, the package remains installed, but MemoraX-backed memory is not
+configured.
+
+After the first installation, restart or refresh the detected clients before
+opening a new session. In Codex, enable **MemoraX Code Codex Adapter** from
+Plugins or `/plugins` if it is not already enabled.
+
+## Verify
+
+```bash
+memorax-code --version
+memorax-code status
+memorax-cli status
+```
+
+For configuration or troubleshooting, see the documentation shipped with the
+package:
+
+- `docs/configuration.md`
+- `docs/troubleshooting.md`
+
+## License
+
+MIT

package/bin/memorax-cli.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { runBackendEntrypoint } from "../lib/run-entrypoint.mjs";
+
+const args = process.argv.slice(2);
+
+if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
+  console.log(`Usage: memorax-cli [status|search|add] [options]
+
+Memory commands:
+  status [--json] [--config-only]
+  search --query TEXT [--session-id ID] [--limit N] [--json]
+  add --memory TEXT --type TYPE --reason REASON [--session-id ID] [--content-type code]
+
+Run the command from the active task workspace so MemoraX Code can enforce its repository scope.`);
+  process.exit(0);
+}
+
+if (args.length === 1 && (args[0] === "--version" || args[0] === "-v")) {
+  const scriptDir = dirname(fileURLToPath(import.meta.url));
+  const pkg = JSON.parse(readFileSync(join(scriptDir, "..", "package.json"), "utf8"));
+  console.log(`memorax-cli ${pkg.version}`);
+  process.exit(0);
+}
+
+await runBackendEntrypoint("memorax-cli.js");

package/bin/memorax-code-backend.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runBackendEntrypoint } from "../lib/run-entrypoint.mjs";
+
+await runBackendEntrypoint("server.js");

package/bin/memorax-code-claude.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runClaudeAdapterCli } from "../lib/run-entrypoint.mjs";
+
+await runClaudeAdapterCli();

package/bin/memorax-code-codex.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCodexAdapterCli } from "../lib/run-entrypoint.mjs";
+
+await runCodexAdapterCli();

package/bin/memorax-code-npm-preinstall.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { unsupportedNodeVersionMessage } from "../lib/node-version.mjs";
+
+const PREFIX = "[MemoraX Code Install]:";
+const PREINSTALL_STOP_TIMEOUT_MS = 45_000;
+const nodeVersionError = unsupportedNodeVersionMessage();
+if (nodeVersionError) {
+  console.error(`${PREFIX} ${nodeVersionError}`);
+  process.exit(1);
+}
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const memoraxCodeBin = join(scriptDir, "memorax-code.mjs");
+const memoraxCodeHome = process.env.MEMORAX_CODE_HOME?.trim() || join(homedir(), ".memorax-code");
+const pidPath = join(memoraxCodeHome, "runtime", "backend", "backend.pid.json");
+
+if (!existsSync(pidPath)) process.exit(0);
+
+console.warn(`${PREFIX} Stopping the existing managed Backend before postinstall setup...`);
+const result = spawnSync(
+  process.execPath,
+  [memoraxCodeBin, "stop", "--home", memoraxCodeHome, "--clients", "none", "--json"],
+  {
+    encoding: "utf8",
+    env: { ...process.env, MEMORAX_CODE_HOME: memoraxCodeHome },
+    stdio: ["ignore", "pipe", "pipe"],
+    timeout: PREINSTALL_STOP_TIMEOUT_MS,
+    killSignal: "SIGKILL",
+  },
+);
+
+if (result.status !== 0 || result.error || existsSync(pidPath)) {
+  printOutput(result.stdout);
+  printOutput(result.stderr);
+  const detail = result.error?.code === "ETIMEDOUT"
+    ? `memorax-code stop timed out after ${PREINSTALL_STOP_TIMEOUT_MS} ms`
+    : result.error?.message
+    ?? (existsSync(pidPath)
+      ? `managed Backend PID authority still exists at ${pidPath}`
+      : `memorax-code stop exited with status ${result.status ?? "unknown"}`);
+  console.error(`${PREFIX} Package setup was stopped because the existing Backend could not be retired safely: ${detail}`);
+  process.exit(1);
+}
+
+console.warn(`${PREFIX} Existing managed Backend stopped; postinstall will start the updated Backend after setup succeeds.`);
+
+function printOutput(output) {
+  for (const line of String(output ?? "").split(/\r?\n/)) {
+    if (line) console.warn(`${PREFIX} ${line}`);
+  }
+}