NeoLi00/memX

NeoLi00 프로필

최근 기록된 소스 활동: 2026년 5월 19일 10:07

SkillsMP 카탈로그 업데이트: 2026년 10월 17일 00:09

수집된 skills: 1

GitHub 스타: 406
GitHub 포크: 3

저장소 README

README 원본 파일: README.md

README 원본 보기

README 전체 펼치기

<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> ## Quick start Requirements: Node.js 22.14+ or Node 24. OpenClaw installs require OpenClaw 2026.3.25+. Python 3 is needed only for the default local embedding runtime. The README commands use the GitHub package spec. A fresh run pulls current GitHub code, so installs do not wait for an npm publish. To use the npm release channel later, replace `github:NeoLi00/memX` with `@neoli00/memx`. Fill in these values before running a command: - `--llm-provider`: the provider adapter memX should call. Choose one of `openai-compatible`, `anthropic`, `google`, or `ollama`. - `--llm-base-url`: the base URL for that provider. Examples: `https://api.openai.com/v1`, `https://api.anthropic.com/v1`, `https://generativelanguage.googleapis.com/v1beta`, or `http://127.0.0.1:11434` for Ollama. - `--llm-model`: the model memX uses for memory compilation, recall planning, and maintenance. Pick a fast, low-cost model with reliable JSON output. - `--llm-api-key`: the API key for the provider. Use `--llm-api-key-env PROVIDER_API_KEY` if you want the config to reference an environment variable instead of storing plaintext. For local Ollama, omit the key. The default embedding setup is local `sentence-transformers-local` with `intfloat/multilingual-e5-small`. Add `--embedding-provider` and `--embedding-model` only when you want to override that default. Use `--dry-run` to preview the files and exec-form commands before writing anything. For Codex and Claude Code, native hooks are the default lifecycle path for automatic recall and turn capture. Quickstart installs the native plugin, writes the shared memX config, starts or refreshes the managed local memX service, and keeps MCP memory tools hidden with `--mcp-tools none` by default. This prevents duplicate recall/write and prevents the agent from reading audit data as a side channel. Use `--mcp-tools full` only when you intentionally want the agent to see the complete MCP tool set. Generic MCP quickstart stays `full` by default because it has no native lifecycle hooks. Default native memories are also host-scoped, so Codex and Claude Code do not share the same local database unless you deliberately override the database path and actor settings. If `http://127.0.0.1:3878` is already used by an unmanaged memX-compatible service, quickstart stops instead of silently reusing it. Stop the old service or pass a free local URL, for example `--memx-url http://127.0.0.1:3888`. ### 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.

저장소 README를 불러오는 중…

이 저장소의 skills

기타 컴퓨터 관련 직업

직업 카테고리 1개 · 100% 분류됨

skill

직업 분류

설명

업데이트

memx

기타 컴퓨터 관련 직업

Use when an agent needs to recall, save, inspect, or audit memX memories through the bundled MCP tools.

원문 언어: 영어

2026-05-19

수집된 skill 1개 중 1개를 표시합니다.

AI 어시스턴트로 설치

이 프롬프트를 복사해 사용 중인 AI 어시스턴트에 입력하세요.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/NeoLi00/memX.