← Back to Skills Marketplace
muninn
by
endgegnerbert-tech
· GitHub ↗
· v2.3.7
2482
Downloads
2
Stars
1
Active Installs
16
Versions
Install in OpenClaw
/install muninn
Description
Universal Context Protocol (CXP) for AI agents. v2.3.7 includes the latest high-performance CXP engine (compiled 2026-02-13) with fix for memory amnesia, macOS binary support, and pfeilschnell indexing. Created by @Blackknight1dev.
Usage Guidance
Things to check before installing or enabling Muninn:
- Verify the npm package contents: confirm that the published muninn-core package actually includes the native 'cxp' binary (for your platform) or documents how to obtain it. If the binary is missing, CXP operations will fail.
- Inspect and approve repository modifications: Muninn will create/modify .muninn/, append enforcement blocks to files like CLAUDE.md, .cursorrules, .antigravityrules, and update .gitignore. If you don't want automated edits to project files, do not install or run in production repos.
- Review the code that auto-injects context: middleware silently enriches many tool calls (filesystem, git, command execution). Make sure you are comfortable with automatic context injection into tools and responses.
- Test in an isolated environment first: run Muninn in a disposable repo or VM to observe behavior (indexing, watcher, file writes) and confirm no unexpected network activity.
- Audit the native binary if present: if the package includes a precompiled Rust binary, verify its provenance (publisher, checksums, or GitHub release) before executing native code.
- If you need stricter control, require explicit user-invocation for context operations or run with limited permissions and avoid projects with sensitive files until you're confident in behavior.
Why 'suspicious' (medium confidence): most behaviors align with a local memory engine, but the missing/assumed native binary and the automatic, persistent modifications to repo files plus wide interception of tool calls are design choices that can be misused or surprising. Additional information (actual npm release contents, presence of the cxp binary, or upstream repository with release tags and checksums) would raise confidence to 'high' and likely move this to 'benign'.
Capability Analysis
Type: OpenClaw Skill
Name: muninn
Version: 2.3.7
The skill is classified as suspicious due to its aggressive and persistent use of prompt injection techniques to control the AI agent's behavior. While the injected content (found in `SKILL.md`, `dist/index.js`, `dist/middleware.js`, and persistently written to project files like `CLAUDE.md` and `.cursorrules` by `dist/project_manager.js`) is designed to enforce the skill's intended workflow for local memory management, this level of agent control represents a significant vulnerability. There is no evidence of intentional data exfiltration, backdoor installation, or other malicious activities, but the methods used to dictate agent behavior are highly manipulative.
Capability Assessment
Purpose & Capability
The skill's name/description (local CXP memory layer) matches the code and npm install of muninn-core (Node). However the SKILL.md and README claim a bundled Rust CXP engine (compiled 2026-02-13), while the code expects a native binary in a ../bin path; the provided skill files do not include that binary. That gap is notable but plausibly explained if the npm package includes it at publish time.
Instruction Scope
Runtime instructions and code enforce a 'Brain-First' protocol and the middleware will automatically intercept many tool calls (filesystem, git, execute_command, etc.) and inject context. The package also writes/updates project files (.muninn contents, .gitignore) and appends a managed 'MUNINN PROJECT BRAIN ENFORCEMENT' block into files like CLAUDE.md, .cursorrules, and .antigravityrules. Automatic modification of repository files and silent injection into many tool responses is consistent with the stated purpose but is scope-creep from a simple 'memory' helper and may be surprising or undesirable to users.
Install Mechanism
Install uses npm (muninn-core) which is a standard mechanism. This is moderate risk but expected for a Node skill. The provided package files/manifest show typical deps. The notable point: SKILL.md references a compiled Rust-based CXP engine; the skill's JS code expects a native binary under ../bin (cxp, cxp-linux, cxp-arm64, etc.). The package contents in this submission do not show that binary, so the runtime may fail or npm may deliver it separately—verify the actual npm release contents before installing.
Credentials
The skill declares no required environment variables or external credentials, and the code does not require cloud keys. A test script and some optional behaviors reference MUNINN_PROJECT_PATH / MUNINN_AUTO_DETECT, but these are not required. No unrelated credentials are requested.
Persistence & Privilege
The skill runs persistent filesystem watchers (chokidar) and writes files under the project (.muninn/), updates .gitignore, and appends managed rule blocks to project files (CLAUDE.md, .cursorrules, .antigravityrules). While this is consistent with a local memory system, it is elevated privilege relative to a read-only context helper and could surprise users or pollute repositories. always:false (no global always-on flag) reduces systemic risk, but the skill still makes persistent, project-local changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install muninn - After installation, invoke the skill by name or use
/muninn - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.3.7
Critical fixes for memory indexing (amnesia), macOS binaries, root-start crashes, and massive indexing performance boost.
v2.3.1
Update to muninn-core 2.3.1 (CXP engine 2026-02-13)
v2.1.14
Final security audit cleanup: Removed emoji headers, expanded semantic triggering metadata, and verified non-aggressive middleware status.
v2.1.13
Security hardening, RCE prevention, and non-aggressive brain enforcement
v2.1.11
V2.1.11: Fully bundled package including CXP Rust engines (linux/arm64/win). Improved AI-to-AI description for maximum context enforcement.
v2.1.9
V2.1.9: Enhanced AI-to-AI instructions for better context enforcement and memory persistence.
v2.1.8
V2.1.8: Branding updated to Muninn MCP, improved robustness, and readiness for public release.
v2.1.7
Updated CXP engine to latest version and fixed process leaks (zombie processes).
v1.6.0
- Updated "Brain-First" Gate Keeper to version 2.1.4 (was 2.1.3)
- Updated dependency on muninn-core to version 2.1.4
- Adjusted documentation and protocol references to reflect the new version
v1.5.0
- Added detailed metadata for integration, including installation info and requirements.
- Expanded and clarified the Muninn Protocol instructions, now suggesting (not mandating) best practices for agents.
- Included a new Tool Reference section, listing all available MCP commands and their purposes.
- Updated installation and setup details for greater clarity and user guidance.
- Added a pro-tip section to highlight efficient context retrieval.
v1.4.0
- Added a dedicated Security & Installation section emphasizing local setup and explicit user consent.
- Updated installation instructions: removed the `-y` flag from `npx [email protected]` to require manual confirmation.
- Clarified that users should run the MCP server locally for transparency.
- Minor rewording for improved clarity and accuracy.
- Updated the description to remove mention of "95% token savings" and streamline feature highlights.
v1.3.0
- Enforced "Brain-First" protocol: Agents must call `brain_check` before accessing other tools; the MCP server now blocks non-exempt tools until orientation is complete.
- Updated documentation to clarify mandatory workflow and new gatekeeping feature.
- Enhanced description to highlight the new v2.1.3 Gate Keeper, emphasizing hallucination prevention and context-awareness.
v1.2.0
- Changed "MUST" to "SHOULD" for agent workflow steps for greater flexibility.
- Removed the "MANDATORY" label from the `brain_check` tool; adjusted its usage description to recommend rather than require.
- Removed the `enforce_rules` tool from the toolset reference.
- Updated `muninn-core` package version to `2.1.3` in the technical integration section.
- Minor language and formatting updates for clarity and conciseness.
v1.1.0
- Added creator attribution ("Created by @Blackknight1dev") to the description field in SKILL.md.
- Bumped skill version from 1.0.1 to 1.1.0.
- Removed the repository field from SKILL.md.
v1.0.1
- Added `homepage` and `repository` fields to skill metadata.
- Updated version number to 1.0.1.
v1.0.0
Initial release of Muninn 1.0.0 – a universal, per-project context memory skill for AI agents.
- Introduces the Context Exchange Protocol (CXP) for efficient, token-saving memory and context handling.
- Provides tools for project initialization, mandatory brain checks, memory management, semantic search, and automated reindexing.
- Enforces a workflow for context checks, semantic searches, and precise memory injection to ensure accuracy and cross-session persistence.
- Integrates with agent environments for seamless usage, storing memories in markdown for version control compatibility.
Metadata
Frequently Asked Questions
What is muninn?
Universal Context Protocol (CXP) for AI agents. v2.3.7 includes the latest high-performance CXP engine (compiled 2026-02-13) with fix for memory amnesia, macOS binary support, and pfeilschnell indexing. Created by @Blackknight1dev. It is an AI Agent Skill for Claude Code / OpenClaw, with 2482 downloads so far.
How do I install muninn?
Run "/install muninn" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is muninn free?
Yes, muninn is completely free (open-source). You can download, install and use it at no cost.
Which platforms does muninn support?
muninn is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created muninn?
It is built and maintained by endgegnerbert-tech (@endgegnerbert-tech); the current version is v2.3.7.
More Skills