by mnemon-dev
LLM-supervised persistent memory for AI agents — graph-based recall, cross-session knowledge, single binary. Works with DeepSeek Harness, Claude Code, OpenClaw, and any agent runtime.
# Add to your Claude Code skills
git clone https://github.com/mnemon-dev/mnemonLast scanned: 5/30/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-30T14:59:16.984Z",
"npmAuditRan": true,
"pipAuditRan": true
}mnemon is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by mnemon-dev. LLM-supervised persistent memory for AI agents — graph-based recall, cross-session knowledge, single binary. Works with DeepSeek Harness, Claude Code, OpenClaw, and any agent runtime. It has 568 GitHub stars.
Yes. mnemon passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/mnemon-dev/mnemon" and add it to your Claude Code skills directory (see the Installation section above).
mnemon is primarily written in Go. It is open-source under mnemon-dev on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh mnemon against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
LLM agents forget everything between sessions. Context compaction drops critical decisions, cross-session knowledge vanishes, and long conversations push early information out of the window.
Mnemon gives your agent persistent, cross-session memory — a four-graph knowledge store with intent-aware recall, importance decay, and automatic deduplication. The mnemon memory path remains one local binary with zero API keys and one setup command.
Mnemon ships one executable with two separate surfaces. Memory stays at the
mnemon root; Agency Preview lives at mnemon agency ... and adds
durable, project-local responsibility and effect admission to an existing Pi
agent. Agency does not replace Memory or the Agent Runtime.
Claude Max / Pro subscriber? Mnemon works entirely through your existing subscription — no separate API key required. Your LLM subscription is the intelligence layer. Two commands and you're done.
Most memory tools embed their own LLM inside the pipeline. Mnemon takes a different approach: your host LLM is the supervisor. The binary handles deterministic computation (storage, graph indexing, search, decay); the LLM makes judgment calls (what to remember, how to link, when to forget). No middleman, no extra inference cost.
| Pattern | LLM Role | Representative |
|---|---|---|
| LLM-Embedded | Executor inside the pipeline | Mem0, Letta |
| File Injection | None — reads file at session start | Claude Code Memory |
| MCP Server | Tool provider via MCP protocol | claude-mem |
| LLM-Supervised | External supervisor of a standalone binary | Mnemon |
Mnemon also addresses a gap in the protocol stack. MCP standardizes how LLMs discover and invoke tools. ODBC/JDBC standardizes how applications access databases. But how LLMs interact with databases using memory semantics — this layer has no protocol. Mnemon's three primitives — remember, link, recall — form an intent-native protocol: command names map to the LLM's cognitive vocabulary (remember not INSERT, recall not SELECT), and output is structured JSON with signal transparency rather than raw database rows.
Memory has a compound interest effect — the longer it accumulates, the greater its value. LLM engines iterate constantly, skill files cost nearly nothing to write, but memory is a private asset that grows with the user. It is the only component in the agent ecosystem worth deep investment.
See Design & Architecture for details.
npm (recommended; macOS / Linux / Windows, Node.js 22+):
npm install --global @mnemon-dev/mnemon
Upgrade the npm-managed CLI at any time:
mnemon update
The npm package installs the matching native Go executable for the host OS and CPU. Mnemon's engine remains a single native binary; Node.js is used only by the npm launcher and package manager.
Alternative installers:
brew install --cask mnemon-dev/tap/mnemon
go install github.com/mnemon-dev/mnemon@latest
Homebrew, go install, source builds, and other Node package managers must
continue to use their original installation method. To migrate one of these
installations, run the npm install command once and ensure the npm global bin
directory precedes the old executable on PATH; subsequent mnemon update
calls are npm-managed.
Windows supports the core Memory commands. Agency remains unavailable on Windows until its local authority boundary has native Windows security.
From source (macOS / Linux):
git clone https://github.com/mnemon-dev/mnemon.git && cd mnemon
make install
Verify installation:
mnemon --version
mnemon agency --version
mnemon agency setup --runtime pi --project-root .
Set up each project once, then use Pi normally. Agency is available on macOS
and Linux and remains independent from Memory: mnemon setup --target pi --yes
enables Memory, while the command above enables Agency. See the
Agency guide for its operating model, Preview compatibility
boundary, and optional peers.
mnemon setup
mnemon setup auto-detects Claude Code, then interactively deploys skill, hooks, and behavioral guide. Start a new session — memory just works.
mnemon setup --target codex --yes
One command deploys the mnemon skill, prompt files, and Codex lifecycle hooks
(SessionStart, UserPromptSubmit, Stop) in .codex/hooks.json.
mnemon setup --target cursor --yes
One command deploys the mnemon skill, prompt files, and Cursor lifecycle hooks
to .cursor/. The integration primes new agent sessions with Mnemon guidance
and memory status, then nudges for durable-memory writeback after responses.
mnemon setup --target zcode --global --yes
ZCode installs the Mnemon skill under ~/.zcode/skills/ and registers
user-level lifecycle hooks in ~/.zcode/cli/config.json. The hooks prime new
sessions, add recall guidance before model calls, and prompt for durable-memory
writeback at stop. Without --global, setup installs only the project skill;
ZCode currently ignores project-level hook configuration.
mnemon setup --target minimax-code --yes
One command deploys the Mnemon skill to
.minimax/skills/mnemon/SKILL.md. Add --global to use
~/.minimax/skills/mnemon/SKILL.md across projects. Current MiniMax Code
releases discover both roots natively. The integration is intentionally
skill-only: in MiniMax Code 3.0.65, the local Agent V2 path does not dispatch
the user-prompt lifecycle hook required for dependable automatic recall.
mnemon setup --target trae --yes
One command deploys the mnemon skill, prompt files, and TRAE native hooks for
both TRAE IDE and TRAE Work to .trae/. The integration uses SessionStart,
UserPromptSubmit, and Stop hooks in .trae/hooks.json.
mnemon setup --target qoder --yes
mnemon setup --target qoderwork --yes
Qoder deploys the mnemon skill, prompt files, and native hooks to .qoder/
or ~/.qoder/. QoderWork uses its native user config at ~/.qoderwork/.
Both integrations register SessionStart, UserPromptSubmit, and Stop
hooks in settings.json.
mnemon setup --target codebuddy --yes
CodeBuddy deploys the mnemon skill, prompt files, and native hooks to
.codebuddy/ or ~/.codebuddy/. The integration registers SessionStart,
UserPromptSubmit, and Stop hooks in settings.json.
mnemon setup --target workbuddy --yes
WorkBuddy deploys the mnemon skill, prompt files, and native hooks to
.workbuddy/ or ~/.workbuddy/. The integration registers SessionStart,
UserPromptSubmit, and Stop hooks in settings.json.
mnemon setup --target kimi --yes
Kimi Code deploys the mnemon skill, prompt files, and native lifecycle hooks to
~/.kimi-code/ or $KIMI_CODE_HOME/. The integration registers
SessionStart, UserPromptSubmit, and Stop hooks in config.toml.
mnemon setup --target opencode --yes
OpenCode deploys the mnemon skill to .opencode/skills/, registers the
generated guide through opencode.json instructions, and installs a native
plugin in .opencode/plugins/. The plugin injects recall context before chat
requests and adds Mnemon guidance to session compaction.
mnemon setup --target openclaw --yes
One command deploys skill, hook, plugin,