agentMemory MCP server
Commit 21. Okt. 2026Bietet AI Coding Agents einen durchsuchbaren lokalen Memory Store, der mit den Memory Bank Markdown-Dateien von KiloCode, Cline und RooCode synchronisiert.
Auch bekannt als webzler/agentMemory
- Stars
- 33
- Tools
- 6
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 21. Okt. 2026
- Lizenz
- MIT
Was ist agentMemory MCP?
agentMemory ist ein MCP server. Bietet AI Coding Agents einen durchsuchbaren lokalen Memory Store, der mit den Memory Bank Markdown-Dateien von KiloCode, Cline und RooCode synchronisiert. Er stellt 6 Tools bereit, etwa memory_write, memory_read, memory_search.
Zusammenfassung generiert aus dem README des Projekts
Über agentMemory MCP server
Die Hauptfunktion von agentMemory besteht darin, AI Coding Agents mit einem durchsuchbaren, persistenten Memory Store auszustatten. Es unterstützt Entwickler, die KiloCode, Cline und RooCode nutzen, indem es die Lücke zwischen manueller Markdown-Dokumentation und strukturierten Daten schließt. Das System nutzt eine Hybrid-Architektur, die eine bidirektionale Synchronisation zwischen einer lokalen JSON-Datenbank und den bestehenden Markdown-Memory-Banks dieser spezifischen Coding-Tools aufrechterhält.
Nutzer installieren den Server über den VS Code Marketplace, der den MCP server automatisch konfiguriert und die notwendigen Anweisungen in die Projektdateien injiziert. Sobald der Server aktiv ist, bietet er programmatischen Zugriff über Tools wie memory_search, memory_write und memory_read. Dieses Setup ermöglicht es Agents, Informationen nach Typ oder Tags abzufragen, ohne ganze Dateien lesen zu müssen, während ein visuelles Dashboard Analysen zum Speicherwachstum und zur Agent-Aktivität liefert. Da das System vollständig lokal und offline-first arbeitet, bleiben alle Daten im Projektverzeichnis des Nutzers und können in die Version Control übernommen werden.
Was du damit machen kannst
- 1Effiziente WissensabfrageEntwickler können einen Agent anweisen, spezifische Coding-Patterns mittels indexierter Suchen zu finden, anstatt jedes File in einem Repository scannen zu müssen.
- 2Projektübergreifender Kontext-AustauschNutzer können Memories über verschiedene Projekte hinweg abfragen, um Konsistenz bei Development-Patterns zu wahren.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
agentMemory MCP tools 6
Erkannt aus dem READMEmemory_writememory_readmemory_searchmemory_listmemory_updatememory_stats
| memory_write | — | |
| memory_read | — | |
| memory_search | — | |
| memory_list | — | |
| memory_update | — | |
| memory_stats | — |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarwebzler/agentmemory is public and reachablegithub.com/webzler/agentmemory ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-21github.com/webzler/agentmemory ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehen🚀 agentMemory
Hybrid Memory System for AI Coding Agents
Seamlessly integrate with KiloCode, Cline, and RooCode's built-in memory banks while providing powerful search, analytics, and automation.
🚀 Now Available as an Antigravity Skill!
agentMemory is now fully compatible with Antigravity. Use it as a skill to give your agents persistent, searchable memory that syncs with your project documentation.
See SKILL.md for usage instructions.
🎯 What Makes agentMemory Different?
KiloCode, Cline, and RooCode already have memory banks - but they're manual and limited.
Their Built-In Memory Banks
.kilocode/rules/memory-bank/ ← Markdown files
.clinerules/memory-bank/ ← Manually updated
.roo/memory-bank/ ← No search capability
The Problem with Native Memory Banks:
- ❌ Manual Maintenance: Agents must manually rewrite files to update memory.
- ❌ No Search: Agents must read entire files to find specific information.
- ❌ No Analytics: No way to track memory growth or patterns over time.
- ❌ Isolated: Memories are locked to a single project.
✅ The Solution: agentMemory
agentMemory fixes these limitations by upgrading your memory bank with:
.agentMemory/ ← Our structured database
├── Bi-directional sync ← Keeps their markdown updated
├── Powerful search ← Query by type, tags, content
├── Visual dashboard ← See trends and analytics
└── MCP tools ← Programmatic access for AI
Benefits:
- ✅ Automatic sync - No manual "update memory bank" needed
- ✅ Searchable - Find memories by query, type, or tags
- ✅ Visual dashboard - Charts, trends, and analytics
- ✅ Cross-project - Query memories across all your projects
- ✅ Compatible - Works WITH their systems, not against them
🏗️ How It Works: Hybrid Architecture
Two-Layer System
┌─────────────────────────────────────────────────────────┐
│ Built-In Memory Banks (Markdown Files) │
│ .kilocode/rules/memory-bank/ │
│ .clinerules/memory-bank/ │
│ .roo/memory-bank/ │
│ ├── Human-readable documentation │
│ ├── Git-committable │
│ └── Read automatically by agents at session start │
└──────────────┬──────────────────────────────────────────┘
│
│ ⬍ Bi-Directional Sync ⬊
│
┌──────────────▼──────────────────────────────────────────┐
│ agentMemory (Structured Storage + MCP Server) │
│ .agentMemory/ │
│ ├── JSON database for fast queries │
│ ├── MCP tools (memory_read, memory_search, etc.) │
│ ├── Dashboard with analytics │
│ └── Cross-project search capabilities │
└─────────────────────────────────────────────────────────┘
The Flow
1. Session Start - Passive Context Loading
AI reads markdown files (.kilocode/rules/memory-bank/)
└─> Contains: Project context + MCP usage instructions
└─> Sees: "This project uses agentMemory MCP tools"
2. During Session - Active Queries
AI needs to find auth patterns
└─> Calls: memory_search({ query: "auth pattern" })
└─> Gets: Structured results from our database
└─> Faster and more accurate than file scanning
3. After Work - Automatic Sync
AI calls: memory_write({ key: "new-feature", ... })
└─> We save to: .agentMemory/ (JSON database)
└─> We sync to: .kilocode/rules/memory-bank/product.md
└─> Next session: They see it in markdown automatically
✨ Key Features
🔄 Bi-Directional Sync
Markdown → MCP
- Parses existing memory bank files
- Imports sections as searchable memories
- Preserves human-friendly docs
MCP → Markdown
- Auto-generates markdown from MCP data
- Appends to appropriate files:
architecture.md← Architecture decisionssystemPatterns.md← Code patternstechContext.md← Tech stack choicesproductContext.md← Featuresprogress.md← Status tracking
� Powerful Search
// Search across ALL memories
memory_search({
query: "authentication",
type: "pattern",
tags: ["security"]
})
// Returns structured results from our database
// Much faster than scanning markdown files
📊 Visual Dashboard
- Memory trends over time
- Agent activity tracking
- Type distribution (architecture vs patterns vs features)
- Recent changes timeline
- Cross-project insights
🤖 Multi-Agent Support
| Agent | Memory Bank Location | Sync Status |
|---|---|---|
| KiloCode | .kilocode/rules/memory-bank/ |
✅ Full sync |
| Cline | .clinerules/memory-bank/ |
✅ Full sync |
| RooCode | .roo/memory-bank/ |
✅ Full sync |
Files Synced:
projectBrief.md/brief.mdarchitecture.md/systemPatterns.mdproductContext.md/product.mdtechContext.md/tech.mdactiveContext.md/context.mdprogress.mddecisionLog.md(RooCode)
📦 Installation
From Marketplace (1-Click)
- Open VS Code
- Extensions → Search "agentMemory"
- Click Install
- Reload VS Code
That's it! The extension will:
- ✅ Create MCP server configuration
- ✅ Inject memory-first instructions into memory banks
- ✅ Start bi-directional sync
- ✅ Enable dashboard
Manual Installation
git clone https://github.com/yourusername/agentMemory
cd agentMemory
npm install
npm run compile
npm run package
code --install-extension agentmemory-0.1.0.vsix
🎮 Usage
For End Users (Zero Config)
Once installed, agentMemory works automatically:
- Import existing memory banks on first run
- Sync new memories as agents create them
- Provide MCP tools for fast queries
- Update markdown files to keep agents in sync
No configuration needed!
For AI Agents (Automatic)
Agents will find mandatory instructions in their memory bank files:
# techContext.md
## agentMemory System (REQUIRED)
This project uses agentMemory for knowledge management.
### Required Workflow
1. Before ANY work: Call memory_search() to check existing knowledge
2. After ANY work: Call memory_write() to document decisions
3. Use memory_read() for specific pattern retrieval
Agents treat this as project architecture and follow it automatically.
🛠️ Memory Tools (MCP)
| Tool | Purpose | Example |
|---|---|---|
memory_write |
Save new memory | Document architecture decisions |
memory_read |
Get specific memory | Retrieve OAuth implementation |
memory_search |
Query by content/tags | Find all auth-related patterns |
memory_list |
List by type | Show all architecture decisions |
memory_update |
Modify existing | Append to existing pattern |
memory_stats |
View analytics | Usage statistics |
� Project Structure
After installation, your project will have:
your-project/
├── .vscode/
│ └── settings.json # MCP server config (auto-created)
│
├── .agentMemory/ # Our structured storage
│ ├── uuid-001.json # Memory: OAuth architecture
│ ├── uuid-002.json # Memory: API patterns
│ └── ...
│
├── .kilocode/rules/memory-bank/ # KiloCode memory bank
│ ├── brief.md # ⬍ Synced with our database
│ ├── architecture.md # ⬍ Auto-updated
│ ├── product.md # ⬍ Auto-updated
│ └── tech.md # ⬍ Auto-updated
│
├── .clinerules/memory-bank/ # Cline memory bank
│ ├── projectBrief.md # ⬍ Synced
│ ├── systemPatterns.md # ⬍ Synced
│ └── ... # ⬍ Synced
│
└── .roo/memory-bank/ # RooCode memory bank
├── projectBrief.md # ⬍ Synced
├── decisionLog.md # ⬍ Synced
└── ... # ⬍ Synced
All markdown files stay human-readable and git-friendly!
💡 Example Workflow
Day 1: Initial Implementation
User → KiloCode: "Create OAuth authentication"
- KiloCode implements OAuth
- Calls:
memory_write({ key: "oauth-impl", type: "architecture", ... }) - agentMemory saves to:
.agentMemory/uuid-001.json(our database).kilocode/rules/memory-bank/architecture.md(their markdown)
Day 3: Extension by Different Agent
User → Cline: "Add Google OAuth provider"
- Cline reads
.clinerules/memory-bank/architecture.md - Sees OAuth documentation (synced from our database)
- Calls:
memory_search({ query: "oauth" }) - Gets structured results instantly
- Implements Google provider consistently
Day 7: New Developer Onboarding
New Dev → RooCode: "How does authentication work?"
- RooCode reads
.roo/memory-bank/systemPatterns.md - Sees complete auth patterns (auto-synced)
- Calls:
memory_read({ key: "oauth-impl" }) - Gets full OAuth architecture doc
- ✅ Instant understanding - Zero learning curve
🎯 Why agentMemory?
| Feature | agentMemory | Built-In Banks | Standalone MCP |
|---|---|---|---|
| Markdown Files | ✅ Synced | ✅ Manual | ❌ No |
| Search | ✅ Fast indexed | ❌ No | ✅ Yes |
| Analytics | ✅ Dashboard | ❌ No | ❌ No |
| Automation | ✅ Auto-sync | ❌ Manual | ⚠️ Partial |
| Multi-Agent | ✅ All 3 | ✅ Per-agent | ✅ All |
| Git-Friendly | ✅ Yes | ✅ Yes | ⚠️ Depends |
| Cross-Project | ✅ Yes | ❌ No | ❌ No |
� Dashboard
Opening Dashboard
Cmd/Ctrl+Shift+P → "agentMemory: Open Memory Dashboard"
Features
- Overview: Total memories, active agents, recent activity
- Charts: Memory types, agent activity, trends over time
- Search: Query memories with filters
- Export: Generate markdown summaries
- Sync Status: See which files are synced
� Privacy & Security
- ✅ 100% Local - No cloud storage
- ✅ Offline-First - Works without internet
- ✅ Git-Friendly - Commit
.agentMemory/to version control - ✅ Open Source - Audit the code yourself
🤝 Contributing
Contributions welcome! See CONTRIBUTING.md
📄 License
MIT © Amit Rathiesh (Webzler Solutions Inc.)
👨💻 Author
Amit Rathiesh
Webzler Solutions Inc.
📧 amitrathiesh@webzler.com
🌐 www.webzler.com
🐙 @amitrathiesh
agentMemory MCP Fragen
Welche Tools bietet agentMemory MCP?
Er stellt 6 Tools bereit, darunter memory_write, memory_read, memory_search, memory_list, memory_update.
Was bewirkt agentMemory für AI Coding Agents?
Es speichert Agent-Memories in einer lokalen JSON-Datenbank mit durchsuchbaren MCP Tools und synchronisiert diese mit den bestehenden Memory Bank Markdown-Dateien, die von KiloCode, Cline und RooCode verwendet werden.
Welche MCP Tools stellt agentMemory bereit?
Es stellt memory_write, memory_read, memory_search, memory_list, memory_update und memory_stats bereit.
Benötigt agentMemory eine Konfiguration?
Die Extension erstellt die MCP server Config und injiziert automatisch Memory-First-Anweisungen, sodass kein manuelles Setup erforderlich ist.
Werden die Daten von agentMemory in der Cloud gespeichert?
Nein, alles wird lokal gespeichert und funktioniert offline. Das .agentMemory Verzeichnis kann zudem in die Version Control eingecheckt werden.
Mit welchen Agents synchronisiert sich agentMemory?
Es synchronisiert die Memory Banks für KiloCode, Cline und RooCode vollständig.