@netzi/recall

Servidor MCP (Model Context Protocol) que da a Claude Code (y cualquier cliente MCP) memoria persistente, selectiva y auto-curada por proyecto, viviendo dentro del propio proyecto (<repo>/.recall/), no en HOME.

Estado del canal: stable. v0.1.2 es el primer release stable de @netzi/recall, promovido al dist-tag latest desde 0.1.2-beta.6. Consolida un cycle de 7 betas que cerraron 8 bugs surfaced via dogfood: B-MCP-1 (Phase-8 patch), B-MCP-2..5 (Phase-11), B-MCP-7 (Phase-13), B-MCP-8 (Phase-15), carryover serverInfo.version (Phase-15 follow-up). 0.1.0 y 0.1.1 hard-deprecadas en npm. Ver release notes + HANDOFF.md §6.21.

---

Idea en 30 segundos

Cada proyecto guarda su memoria en <proyecto>/.recall/. La memoria viaja con el codigo cuando lo clonas, lo mueves, lo compartes. Tres modos:

Modo	Que ocurre
Compartido (default)	Memoria en git plano — el equipo la ve
Encriptado	Memoria en git cifrada con SQLCipher — el equipo necesita clave
Privado	Memoria en .gitignore — solo en tu maquina

El cliente MCP llama mem.context, mem.recall, mem.remember, mem.task, mem.health para persistir y recuperar memoria estructurada con hybrid search (BM25 via FTS5 + cosine via sqlite-vec). El curador hace decay, consolidacion y self-healing en background.

Diferenciador clave vs Mem0, OpenMemory, LangMem y otros: la memoria vive con el codigo, tiene 3 modos de privacidad nativos, y el dominio esta tipado en el lenguaje del software (decisions, learnings, entities, tasks, turns) en vez de "facts" planos.

---

Quick start

# Stable channel — v0.1.2 (primer release stable, promovido desde
# 0.1.2-beta.6 tras 7 betas que cerraron 8 bugs via dogfood loop)
npm install -g @netzi/recall

cd /tu/proyecto
recall init                       # crea <proyecto>/.recall/
recall health                     # verifica install

# Conectar a Claude Code
claude mcp add recall recall-server

Detalle completo en docs/07-instalacion.md.

---

Estructura del repositorio

.
├── docs/                # Documentacion completa (especificacion + lineamientos)
├── code/                # Implementacion del servidor MCP (TypeScript)
│   ├── src/             # ~58.8k LOC, 8 modulos + shared + composition + bootstrap
│   ├── tests/           # 2501 tests, coverage 96.4%, 205 archivos
│   ├── migrations/      # 8 migraciones SQLite
│   └── package.json     # @netzi/recall
├── .claude/agents/      # 13 agentes especialistas (orquestador + 6 implementadores + 6 validadores)
├── .github/workflows/   # CI: typecheck + lint + validate:modules + build + test:coverage + sonar
├── HANDOFF.md           # Estado del proyecto, decisiones, bugs abiertos, roadmap
├── CONTRIBUTING.md      # GitFlow rules, release flow, hotfix flow, ADR list
└── README.md            # Este archivo

---

Por donde empezar

Si vas a usarlo:

1. docs/07-instalacion.md — setup en clientes MCP
2. docs/08-casos-uso.md — 13 casos de uso end-to-end
3. docs/02-protocolo-mcp.md — contrato de tools

Si vas a contribuir:

1. CONTRIBUTING.md — GitFlow + reglas de PR
2. docs/12-lineamientos-arquitectura.md — 6 reglas no negociables (Clean + Hexagonal + DDD + SOLID + modularidad estricta + cero any)
3. docs/13-workflow-agentes.md — 13 agentes, ciclo de validacion, SonarQube
4. HANDOFF.md — estado completo del proyecto

Si quieres entender el producto:

1. docs/README.md — resumen ejecutivo + indice
2. docs/01-arquitectura.md — vision tecnica
3. docs/11-seguridad-modos.md — los 3 modos

---

Reglas no-negociables del codigo

Todo el codigo cumple 6 lineamientos absolutos (detalle):

1. Clean Architecture — dependencias apuntan al dominio
2. DDD — entidades, VO, agregados, ubiquitous language
3. Hexagonal — puertos en domain/application, adapters en infrastructure
4. SOLID — los 5 principios validados por agente
5. Modularidad estricta — modulos no se importan entre si; solo shared/
6. Cero any — type-safety total con tsc --strict

Validados en CI por SonarQube: gate "MCP Memoria Strict", cobertura ≥95%, 0 bugs / 0 vulnerabilidades / 0 blockers / 0 critical, ratings A.

---

Stack

• TypeScript strict, Node 20+
• better-sqlite3-multiple-ciphers + sqlite-vec + fastembed
• @noble/hashes (argon2id), pino, uuid v7, zod
• vitest + eslint v9 strict + tsup

Detalle: docs/06-stack-tecnico.md.

---

Issues / bugs / preguntas

• Issues abiertos — 0 al cierre del cycle 0.1.2-beta.* y promote a 0.1.2 stable. Cycle completo: B-MCP-2..5 cerrados en v0.1.2-beta.3 via PRs #17/#18/#19/#20; B-MCP-7 cerrado en v0.1.2-beta.4 via PR #27; B-MCP-8 cerrado en v0.1.2-beta.5 via PR #33; carryover cosmetico serverInfo.version cerrado en v0.1.2-beta.6 via PR #37; promote a stable en v0.1.2
• Reportar vulnerabilidades de seguridad: ver SECURITY.md
• Discusiones generales: GitHub Discussions

---

Licencia

MIT. Ver code/LICENSE.

Copyright (c) 2026 Netzi Tech.