← Back to Skills Marketplace
235
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install cxm-neural-memory
Description
Use this skill when you need to understand the architecture of a codebase, perform semantic searches across files, map dependencies before refactoring, or in...
README (SKILL.md)
CXM Neural Memory Skill
This skill provides you with a localized "Neural Memory" and architectural mapping tool. It allows you to find code semantically and map dependencies using bundled AST-parsing tools.
🔒 Security & Transparency (Disclosure)
To ensure safe and transparent operation, be aware of the following behaviors:
- Local Indexing: This skill performs recursive file reads within the project to build a local vector index (FAISS) stored in
~/.cxm. - Resource Footprint: Initial indexing is CPU-intensive. Runtime RAM usage ranges from ~300MB (Mini-BERT) to ~1GB (MPNet).
- Network Access: On the very first execution, this skill will download a pre-trained model (~80MB to ~400MB) from the HuggingFace Hub. No project data is ever uploaded.
- File Modification: The tool can patch files. It strictly respects the
allowed_write_pathsandmode(e.g.,ask_first) defined in the project's.cxm.yaml.
🛠️ Local Engine Usage
You are already bundled with the CXM source code. All commands must be executed via the local src/cli.py script.
Crucial Instruction: Always use the --agent-mode flag to receive strict, parseable JSON.
Core Capabilities & Usage
1. Semantic Search (Vibe Searching)
Use this when you need to find logic by its purpose, even if you don't know the exact file name or variable names.
Command:
python src/cli.py --agent-mode harvest --semantic "your natural language query"
Interpretation:
The JSON output contains a results array with path, content, and start_line/end_line for precise targeting.
2. Dependency Graphing (Architectural Mapping)
Use this before refactoring to see which files or modules depend on your target file.
Command:
python src/cli.py --agent-mode map path/to/file.py
Interpretation:
The JSON output includes an edges list and a hotspots array showing the most heavily used modules in the project.
3. Architecture Ingestion
Force CXM to index non-code files like README.md, docker-compose.yml, or package.json to understand the system's infrastructure.
Command:
python src/cli.py --agent-mode ingest .
Workflow for Complex Refactoring
- Locate: Use
semantic searchto find the relevant code sections. - Map: Run
mapon the identified files to see the blast radius. - Execute: Apply your changes knowing the full architectural context.
Usage Guidance
What to consider before installing/using this skill:
- Review the code that reads system and third-party CLI state: docs/cli-reference and code reference reading Gemini/Claude session directories (e.g., ~/.gemini/tmp/partner/chats/, ~/.claude/projects/). If you use those CLIs, expect CXM to ingest their session data unless configured otherwise.
- Audit file-patching code and .cxm.yaml before allowing write actions. The tool can modify files and claims to respect allowed_write_paths/modes, but verify patcher.py and any guard logic yourself and keep backups/strict git workflow in place.
- Do not run pip install -r requirements.txt or the editable (-e) installs without inspection: requirements.txt contains -e git+ssh/git+https entries to personal repos and a very large dependency set (heavy ML and network libraries). Prefer running the CLI in an isolated environment (container or VM) and pin exact dependency sources if you must install.
- Expect network activity: first-run model downloads from HuggingFace and optional GitHub cloning. If you need fully offline operation, verify local-model paths or block network access and confirm behavior.
- If you plan to let agents call this skill autonomously, consider restricting agent privileges (prevent file writes or disallow background watcher) or require explicit human approval for any patch operations; autonomous invocation combined with cross-CLI reads raises privacy risk.
If you want to proceed safely: run the tool inside an isolated container or throwaway VM, inspect/grep context_gatherer, patcher, and skill_exporter, and test read/write behaviors on a benign project first. If anything is unclear, ask the maintainer for explicit documentation on allowed_write_paths, what session locations are read, and which remote endpoints the install or runtime will contact.
Capability Analysis
Type: OpenClaw Skill
Name: cxm-neural-memory
Version: 1.0.3
The bundle implements a 'Context Machine' (CXM) designed to provide AI agents with deep local context, but it employs several high-risk data gathering techniques. Specifically, 'src/tools/context_gatherer.py' reads sensitive local data including the user's shell history (~/.bash_history) and private session logs from other AI tools like Gemini and Claude Code. Additionally, 'src/core/patcher.py' enables the AI to automatically modify or patch files on the local system. While the tool includes notable security features such as a secret masker to redact API keys from its index ('src/core/rag.py') and a guardrail system to restrict file-writing paths, the broad access to personal history and the capability for automated filesystem modification constitute a significant security and privacy surface.
Capability Assessment
Purpose & Capability
Name/description match the main code: semantic search, dependency mapping, and ingestion. The repository includes a full CLI and RAG engine implementing those capabilities (src/core/rag.py, src/cli.py, tools). However the docs and code also describe integrating system state and third-party CLI session files (Gemini/Claude), cloning remote repos, and auto-updating a background watcher — behaviors that are broader than a simple 'codebase understanding' tool and should be expected but explicitly reviewed.
Instruction Scope
SKILL.md and other docs instruct the agent to run the bundled CLI (python src/cli.py --agent-mode) which will: recursively read the project to build an index (~/.cxm), download models from HuggingFace on first run, optionally run a background watcher that updates the index on file saves, patch files respecting .cxm.yaml rules, and gather context from other tool locations (docs mention reading ~/.gemini/tmp/partner/chats/ and ~/.claude/projects/). The skill therefore reads files and session histories outside the immediate project scope and can modify files — these are significant scope expansions that the user should expect and control.
Install Mechanism
There is no automatic install spec in the registry entry (instruction-only), which reduces platform-level install risk. However the package metadata and requirements.txt recommend installing heavy dependencies and include -e git+ssh/git+https editable installs pointing to personal GitHub repositories (e.g., Joeavaib/partner and other -e entries). If a user follows docs to pip install, that will pull code from external repos and many third-party packages (faiss, sentence-transformers, huggingface_hub, Google/Anthropic clients etc.). Those remote/editable installs and the large dependency set increase supply-chain risk and deserve manual review.
Credentials
The skill declares no required environment variables or credentials. That aligns with local-only operation. Nevertheless, behavior in code/docs will access local Git and may clone remote GitHub repos (using the user's git config/SSH keys) and will download models from HuggingFace (network activity). The tool also scans files for secrets (masking), but it can read unrelated session files (Gemini/Claude) and system/git status — this is broader access than just source files and could expose sensitive local data if used without care.
Persistence & Privilege
always:false (good). The tool creates persistent data under ~/.cxm (index, metadata, caches) and supports a background watcher/daemon to keep indices fresh; it can also apply patches to workspace files (subject to .cxm.yaml allowed_write_paths and modes like 'ask_first'). Autonomous agent invocation is permitted by default; combined with the above (reading other CLIs and file-patching), that increases the blast radius, so consider restricting runtime permissions or requiring human confirmation for write actions.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cxm-neural-memory - After installation, invoke the skill by name or use
/cxm-neural-memory - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Added a new "Security & Transparency" section to the documentation, detailing local indexing, resource usage, first-run model download, and file modification safeguards.
- Removed the `.cxm.yaml` and `docs/LICENSE.md` files.
v1.0.2
Found out how to manually Upload
v1.0.1
Added the rest lol
v1.0.0
Initial release of cxm-neural-memory skill.
- Enables semantic search across codebases using natural language queries.
- Provides dependency graph mapping to assess "blast radius" before refactoring.
- Supports ingestion of code and non-code (documentation/config) files into memory for richer architectural context.
- Offers guidance on syncing background file changes for up-to-date context.
- Includes a recommended workflow for safe and effective complex refactoring.
Metadata
Frequently Asked Questions
What is CXM: Neural Memory for Agents?
Use this skill when you need to understand the architecture of a codebase, perform semantic searches across files, map dependencies before refactoring, or in... It is an AI Agent Skill for Claude Code / OpenClaw, with 235 downloads so far.
How do I install CXM: Neural Memory for Agents?
Run "/install cxm-neural-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is CXM: Neural Memory for Agents free?
Yes, CXM: Neural Memory for Agents is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does CXM: Neural Memory for Agents support?
CXM: Neural Memory for Agents is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created CXM: Neural Memory for Agents?
It is built and maintained by Joeavaib (@joeavaib); the current version is v1.0.3.
More Skills