MCP server de agentMemory
Commit 21 oct 2026Proporciona a los agentes de codificación de IA un almacén de memoria local con capacidad de búsqueda que se sincroniza con los archivos markdown de memoria de KiloCode, Cline y RooCode.
También conocido como webzler/agentMemory
- Stars
- 33
- Herramientas
- 6
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 21 oct 2026
- Licencia
- MIT
¿Qué es agentMemory MCP?
agentMemory es un MCP server. Proporciona a los agentes de codificación de IA un almacén de memoria local con capacidad de búsqueda que se sincroniza con los archivos markdown de memoria de KiloCode, Cline y RooCode. Expone 6 herramientas, como memory_write, memory_read, memory_search.
Resumen generado a partir del README del proyecto
Acerca del MCP server de agentMemory
La función principal de agentMemory es proporcionar a los agentes de codificación de IA un almacén de memoria persistente y con capacidad de búsqueda. Sirve a los desarrolladores que utilizan KiloCode, Cline y RooCode al cerrar la brecha entre la documentación manual en markdown y los datos estructurados. El sistema utiliza una arquitectura híbrida que mantiene una sincronización bidireccional entre una base de datos JSON local y los bancos de memoria markdown existentes utilizados por estas herramientas de codificación específicas.
Los usuarios instalan el servidor a través de VS Code Marketplace, lo que configura automáticamente el MCP server e inyecta las instrucciones necesarias en los archivos del proyecto. Una vez activo, el servidor proporciona acceso programático a través de herramientas como memory_search, memory_write y memory_read. Esta configuración permite que los agentes consulten información por tipo o etiquetas sin tener que leer archivos completos, mientras que un panel visual proporciona analíticas sobre el crecimiento de la memoria y la actividad del agente. Debido a que el sistema es completamente local y funciona primero sin conexión, todos los datos permanecen dentro del directorio del proyecto del usuario y pueden incluirse en el control de versiones.
Qué puedes hacer con él
- 1Recuperación eficiente de conocimientosLos desarrolladores pueden instruir a un agente para que encuentre patrones de codificación específicos utilizando búsquedas indexadas en lugar de escanear cada archivo en un repositorio.
- 2Intercambio de contexto entre proyectosLos usuarios pueden consultar memorias de diferentes proyectos para mantener la consistencia en los patrones de desarrollo.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de agentMemory MCP 6
Detectado desde el READMEmemory_writememory_readmemory_searchmemory_listmemory_updatememory_stats
| memory_write | — | |
| memory_read | — | |
| memory_search | — | |
| memory_list | — | |
| memory_update | — | |
| memory_stats | — |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblewebzler/agentmemory is public and reachablegithub.com/webzler/agentmemory ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-21github.com/webzler/agentmemory ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHub🚀 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
Preguntas sobre agentMemory MCP
¿Qué herramientas proporciona agentMemory MCP?
Expone 6 herramientas, incluidas memory_write, memory_read, memory_search, memory_list, memory_update.
¿Qué hace agentMemory por los agentes de codificación de IA?
Almacena las memorias de los agentes en una base de datos JSON local con herramientas MCP de búsqueda y las sincroniza con los archivos markdown de los bancos de memoria utilizados por KiloCode, Cline y RooCode.
¿Qué herramientas MCP expone agentMemory?
Proporciona memory_write, memory_read, memory_search, memory_list, memory_update y memory_stats.
¿Requiere configuración agentMemory?
La extensión crea la configuración del MCP server e inyecta automáticamente las instrucciones de prioridad de memoria, por lo que no es necesario realizar una configuración manual.
¿Los datos de agentMemory se almacenan en la nube?
No, todo se almacena localmente y funciona sin conexión, y el directorio .agentMemory se puede incluir en el control de versiones.
¿Con qué agentes se sincroniza agentMemory?
Sincroniza completamente los bancos de memoria para KiloCode, Cline y RooCode.