Skip to main content
Glama

episteme: Agentic Memory & Knowledge Vault. Persistent Knowledge Engine for AI Workflows.

episteme

Documentación y memoria de proyectos para agentes, servida por MCP desde un vault Markdown


Qué es

Claude Code es como un colega brillante que cada mañana llega sin recordar nada de ayer.

Claude Code empieza cada sesión sin recordar la anterior. episteme le da una memoria que dura: una carpeta de notas en Markdown (el vault) donde quedan las decisiones, las lecciones y la documentación de tus proyectos, y que Claude consulta y completa mientras trabaja.

Qué hace por ti

Recuerda

Guarda decisiones, lecciones, errores y preferencias como notas ordenadas por proyecto

Encuentra

Busca en todo el vault, en español, sin distinguir mayúsculas ni tildes

Avisa a tiempo

Antes de editar un archivo, muestra las normas que le aplican; después, lo que ya se sabe de él

Retoma

Guarda en qué ibas antes de que la conversación se compacte y lo recupera después

Cuida el orden

Detecta duplicados, memorias vencidas, enlaces rotos y memorias sin enlazar; rechaza guardar contraseñas y tokens

Las notas son archivos de texto tuyos: se abren con Obsidian o con cualquier editor, y no dependen de ningún servicio externo.

NOTE

Versión actual: v0.13.2. Funciona en Linux, macOS y Windows. Las novedades de cada versión están en el CHANGELOG.

Related MCP server: vault-mcp

Cómo funciona

  1. Claude Code habla con episteme de dos formas: el agente usa sus herramientas cuando las necesita, y los hooks las llaman solos en momentos fijos de la sesión.

  2. episteme es un programa pequeño que corre en tu máquina. Es la única puerta al vault: valida lo que se guarda y mantiene un índice para buscar rápido.

  3. El vault es una carpeta de notas Markdown, por defecto ~/.episteme. Tú puedes leerlo y editarlo con Obsidian.

Término

Qué significa

Vault

La carpeta con todas las notas. Se divide en zonas: documentación, memorias, planes

Memoria

Una nota corta con algo que vale la pena recordar: una decisión, una lección, un recordatorio

Herramienta (tool)

Una acción que Claude puede pedirle a episteme: buscar, leer, guardar

Hook

Un automatismo de Claude Code que llama a una herramienta sin que nadie lo pida

MCP

El protocolo estándar con el que Claude Code se conecta a programas como episteme

Instalación

Necesitas uv y git. uv consigue Python por ti si falta.

Opción A · Con la skill (recomendada)

Las skills vienen en un plugin de Claude Code. Se instala una vez por máquina, con dos comandos (igual en Linux, macOS y Windows):

claude plugin marketplace add Bajmein/episteme
claude plugin install episteme@episteme

Más detalles (actualizar, quitar) en la guía de instalación.

Después, en cada proyecto que quieras conectar:

  1. Reinicia Claude Code y ábrelo en la raíz del proyecto.

  2. Escribe /episteme:setup.

  3. Aprueba los cambios que te muestra. La skill registra el servidor, configura los hooks y los permisos, y añade la regla al CLAUDE.md.

El plugin trae además estas skills:

Skill

Para qué

/episteme:pausa

Guardar en qué estabas antes de /clear o de cerrar, y retomarlo después con /episteme:pausa retomar

/episteme:mantencion

Revisar las memorias contigo: unificar las repetidas, resolver contradicciones y archivar lo vencido. Con corta hace una ronda rápida de 3 casos; con huerfanas, enlaza las memorias que quedaron sueltas

/episteme:reminder <texto>

Dejar un recordatorio que sale al empezar cada sesión del proyecto

Opción B · A mano

Un solo comando registra el servidor. Cambia <proyecto> por el nombre del tuyo.

Linux y macOS

claude mcp add --scope local episteme -- \
  uvx --from git+https://github.com/Bajmein/episteme@v0.13.2 episteme --project <proyecto>

Windows (PowerShell, en una sola línea)

claude mcp add --scope local episteme -- uvx --from git+https://github.com/Bajmein/episteme@v0.13.2 episteme --project <proyecto>

Luego faltan los hooks, los permisos y la regla del CLAUDE.md: los pasos están en la guía de instalación.

TIP

Para comprobar que quedó bien,claude mcp list debe mostrar episteme conectado. La primera vez tarda un poco, porque se descarga. Para actualizar, repite el registro con el tag nuevo.

Uso diario

No hay comandos que aprender: se usa conversando con Claude.

Tú

episteme

Empiezas una sesión

Le entrega a Claude las normas del proyecto, los recordatorios vencidos y las memorias más importantes

Escribes un mensaje

Sugiere las memorias que vienen al caso

Dices «recuerda que…»

Guarda una memoria nueva, salvo que ya exista una casi igual

Preguntas «¿qué decidimos sobre…?»

Claude busca en el vault antes de responder

Claude va a editar un archivo

Le muestra las normas que aplican a ese archivo

La conversación se compacta o la limpias con /clear

Al compactar guarda el estado del trabajo; en los dos casos lo recupera al seguir

Lo que pasa solo en cada sesión

Los hooks nunca bloquean a Claude ni deciden por él: solo le acercan contexto. Funcionan como un semáforo, no como un muro: Claude puede leer la norma y aun así equivocarse. La configuración está en Hooks.

Quién hace qué y cuándo

Cuándo

Quién

Qué pasa

Al escribir un mensaje

hook

La primera vez entrega la bienvenida; después sugiere memorias que vienen al caso

Antes de editar un archivo

hook

Muestra las normas de ese archivo. No pausa ni bloquea la edición

Después de leer o editar un archivo

hook

Muestra lo que ya se sabe de él

Al compactar o con /clear

hook

Al compactar guarda el estado del trabajo; después de compactar o de /clear, lo recupera

En la primera bienvenida, como mucho una vez por periodo

episteme

Avisa de lo pendiente de revisar y propone una ronda corta; si lo activas, archiva lo vencido y hace un backup

Cuando lo necesita

Claude

Busca, lee, guarda («recuerda que…») y corrige memorias

Cuando tú lo pides

tú

/episteme:mantencion para revisar y ordenar

Guardar una memoria siempre lo decide Claude: ningún hook copia lo que escribes. episteme no revisa el vault en segundo plano: la revisión corre cuando alguien la pide.

Las 10 herramientas

Herramienta

Para qué sirve

Escribe

search

Buscar en las notas y las memorias

read

Leer una nota, una sección o varias notas a la vez

links

Ver qué notas enlazan con otra

context

Dar la bienvenida de la sesión y reunir lo relevante para una tarea

●

surface

Mostrar lo que se sabe de un archivo

constraints

Mostrar las normas que aplican a un archivo

remember

Guardar una memoria nueva; avisa si le faltan palabras clave o enlaces

●

revise

Corregir, reemplazar o archivar una nota

●

review

Revisar el vault: duplicados, vencidas, enlaces rotos y memorias sueltas, con sugerencias de a qué enlazarlas

checkpoint

Guardar y recuperar el estado del trabajo

●

Los parámetros y el comportamiento exacto de cada una están en Tools y memorias.

Tipos de memoria

Tipo

Qué guarda

decision

Algo que se decidió y por qué

constraint

Una norma que hay que respetar al tocar ciertos archivos

lesson

Algo aprendido que conviene repetir o evitar

error

Un fallo y cómo se resolvió

preference

Cómo le gusta trabajar a la persona

insight

Un hallazgo o una conclusión

reminder

Algo pendiente, con fecha

session

El estado del trabajo, guardado al compactar

Cada memoria lleva una prioridad del 1 al 5: las de prioridad 5 son las normas que Claude ve al empezar cada sesión.

Límites

  • Busca por palabras, no por significado. «marketing» no encuentra una nota que solo dice «mkt». Por eso cada memoria lleva keywords con sinónimos y siglas, que Claude añade al guardar.

  • Avisa, no obliga. Las normas llegan a Claude a tiempo, pero nada le impide ignorarlas.

  • No se ordena solo. Unificar memorias repetidas y resolver contradicciones lo apruebas tú, con /episteme:mantencion. Conviene activar archive_expired = true (ver Mantención).

  • El filtro de contraseñas conoce los formatos habituales. Una clave con un formato raro puede pasar: no dictes secretos.

Documentación

El detalle técnico vive en docs/:

Documento

Contenido

Instalación

Pasos a mano en Linux, macOS y Windows, y el plugin con las skills

Configuración

Argumentos del servidor, variables, episteme.toml, zonas y registro de actividad

Tools y memorias

Las 10 herramientas con sus parámetros, el esquema de las memorias y los errores

Hooks

El bloque para settings.json, los permisos recomendados y cómo comprobar que funcionan

Mantención

Avisos, archivado de memorias vencidas, backup y el ciclo de revisión

Migración de OMEGA

Cómo traer las memorias de OMEGA

Desarrollo

Tests, lint, salud del código y scripts de medición

CHANGELOG

Cambios de cada versión

Desarrollo

uv sync            # instala las dependencias
uv run ruff check  # lint
uv run pytest      # tests

El resto (el lint completo del CI, la revisión de calidad de cada PR con CodeScene y los scripts de medición) está en Desarrollo.

Licencia

MIT, © 2026 Benjamín Criado.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables coding agents to use an Obsidian vault as long-term memory, with search, reading, and writing of notes, plus automatic capture of learnings that are propagated to MOCs, daily notes, and the knowledge index with git commits.
      9
      62 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Turns an Obsidian vault of plain Markdown notes into memory shared by every Claude client, so notes, people, meetings, and follow-ups carry across chats and devices. Provides tools to search, read, capture, write, and link notes, and to track people, organizations, connections, and interactions.
      17
      MIT