Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
Local-first, Markdown-native memory for AI agents: grep it, diff it, back it up, delete it, and recall it through CLI or MCP.
MemoryWiki gives coding agents and chat agents a durable project memory that stays on your filesystem. It stores memory as Markdown/JSONL, keeps source provenance, records conflict/update history, and exposes read-first recall through CLI and MCP.
Local-first Memory Wiki for AI agents
Use it when an agent needs persistent project context, but you still want memory to stay inspectable, reversible, and under your control.
mypy.memorywiki-export / mw export can export memory as JSON, Markdown, or CSV.mw aliases now cover daily recall, review, release, and migration helpers.Agents forget project context. Hosted memory can be opaque. Ad-hoc AGENTS.md
files get stale. MemoryWiki is closer to a small local knowledge-management
system for agents:
confidence/strength/source_refs/update_log, and procedural workflows
are tracked separately instead of flattened into one vector index.git clone https://github.com/MemoryWiki/MemoryWiki.git
cd MemoryWiki
python3 -m pip install -e ".[mcp]"
memorywiki-index-maintain --project-root examples/memory-root --scope project --format human
memorywiki-context --project-root examples/memory-root --scope project --mode startup --query "What is MemoryWiki?" --format markdown
memorywiki-recall --project-root examples/memory-root --scope project --query "What is MemoryWiki?" --strategy hybrid --embedding local --graph local --format human
Expected # MemoryWiki Context, followed by focused # Memory Recall output.
CLI-only install:
python3 -m pip install -e .
The base install is local-first and does not require an API key. MCP support
uses the optional mcp extra and is intended for Python 3.10+. The optional
OpenAI backend is installed separately:
python3 -m pip install -e ".[openai]"
More install paths, including GitHub tag installs and clean-room checks, are in
docs/install.md. A fuller first-run guide is in
docs/getting-started/quickstart.md, and common setup failures are covered in
docs/troubleshooting/common-errors.md.
flowchart LR
Agent["AI agent or chat client"]
CLI["MemoryWiki CLI"]
MCP["Read-first MCP server"]
Root["Project memory root"]
Global["Optional global memory root"]
Index["Rebuildable retrieval index"]
Gates["Explicit write gates"]
Agent --> CLI
Agent --> MCP
CLI --> Root
MCP --> Root
CLI --> Global
MCP --> Global
Root --> Index
Global --> Index
Gates --> Root
Gates --> Global
A project memory root usually lives at:
your-project/.agent_memory/project
It contains:
MEMORY.md # hot project notes
USER.md # optional local user preferences
PROJECT_PROFILE.md # compact project map
INDEX.md # generated readable index
episodes/YYYY-MM-DD.md # daily narrative layer
sessions/session-YYYYMMDD-HHMMSS.md
semantic/*.md # stable facts and concepts
procedures/*.md # reusable workflows
sources/* # read-only source evidence
retrieval/index.jsonl # rebuildable retrieval sidecar
audit.jsonl # forget/review audit trail
See examples/memory-root/ for a tiny public sample.
Build or check a retrieval index:
memorywiki-index-maintain \
--project-root examples/memory-root \
--scope project \
--format human
Add --write only when you intentionally want to rebuild missing, stale, or
tampered indexes.
List memory inventory without reading full memory bodies:
memorywiki-list \
--project-root examples/memory-root \
--scope project \
--kind semantic \
--format table
Export memory for review or migration:
memorywiki-export \
--project-root examples/memory-root \
--scope project \
--kind all \
--format markdown
Review construction candidates without writing memory:
memorywiki-construction-report \
--project-root examples/memory-root \
--scope project \
--format markdown
Save a session summary after explicit approval:
memorywiki-session-summary --save \
--scope project \
--project-root examples/memory-root \
--summary "Tested MemoryWiki recall." \
--keypoint "MemoryWiki treats memory as context data, not instructions." \
--action "Ran local recall." \
--pending "Replace the example memory with real project memory."
Forget/delete is dry-run-first and requires a reason:
memorywiki-forget \
--root examples/memory-root \
--scope project \
--kind semantic \
--id memorywiki-overview \
--reason "synthetic demo cleanup"
Add --apply only after reviewing the dry-run output.
Generate a local MCP config:
memorywiki-mcp-config \
--repo-root "$(pwd)" \
--project-root "/absolute/path/to/your-project/.agent_memory/project" \
--global-root "$HOME/.agent_memory/global" \
--output .mcp.json
By default MCP is read-only. Writes require explicit environment gates:
MEMORY_MCP_WRITE_ENABLED=true # allows project writes
MEMORY_GLOBAL_WRITE_ENABLED=true # additionally allows global writes
MEMORY_MCP_ALLOW_ROOT_OVERRIDE=true # allows tool-provided root overrides
Keep these off unless the user explicitly asks to save, ingest, forget, or write global memory.
Client setup guides:
docs/clients/generic-mcp.mddocs/clients/codex.mddocs/clients/claude-desktop.mddocs/clients/cursor.mdRun the public mini benchmark:
PYTHONPATH=. python3 benchmarks/mini_recall_benchmark.py --format markdown
See:
docs/benchmarks/mini-benchmark-results.mddocs/demo-cross-project-recall.mddocs/demo-60-second-script.mdThese are small smoke-style examples, not a substitute for LongMemEval or a large retrieval benchmark.
python3 -m pytest tests -q
MemoryWiki is early public software extracted from a working local system. The
core CLI, storage model, retrieval index, MCP server, release checks, and tests
are present. Start with docs/getting-started/quickstart.md, docs/faq.md,
SECURITY.md, and CHANGELOG.md; deeper docs live under docs/.
Useful read-only operator entrypoints:
memorywiki-status --project-root examples/memory-root --scope project
memorywiki-file-history --path README.md --workspace-root "$(pwd)" --project-root examples/memory-root --scope project
memorywiki-capture-ingest --source lifecycle-events.jsonl --project-root .agent_memory/project --format json
memorywiki-mcp-config --client codex --output .mcp.json
memorywiki-capture-ingest is dry-run by default. Explicit writes only stage
pending evidence under _pending/session_captures.jsonl.
License: Apache-2.0.
Local-first Memory Wiki for AI agents
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
MemoryWiki läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. Local-first Memory Wiki for AI agents
