Repolode
Enviar
ramakay

ramakay/claude-self-reflect

Herramienta local en Rust que dota a Claude Code de memoria persistente de conversaciones anteriores mediante búsqueda semántica y se ofrece como servidor MCP.

Ver en GitHub
Estrellas
229
Forks
29
Issues abiertos
11
Último commit
hace 4 días

¿Qué es?

Claude Self-Reflect es una capa de memoria para Claude Code. Indexa transcripciones de conversaciones anteriores de ~/.claude/projects y permite buscarlas, para recuperar cuando sean relevantes soluciones, decisiones de diseño e historial de depuración de sesiones previas. Se distribuye como un único binario de Rust que almacena fragmentos, embeddings y el estado del enriquecimiento en SQLite, y utiliza un índice HNSW para la búsqueda vectorial con embeddings locales de FastEmbed. La búsqueda básica no requiere un servidor de base de datos, un contenedor ni una clave de API.

La herramienta registra un servidor MCP en Claude Code e instala seis hooks del ciclo de vida (SessionStart, UserPromptSubmit, PostToolUse, Stop, PreCompact, SessionEnd) que inyectan automáticamente contexto relevante de conversaciones anteriores. Ofrece 15 herramientas MCP para realizar consultas explícitas, como buscar por archivo o concepto, consultar una cronología y el trabajo reciente, recuperar conversaciones completas y explorar un grafo de código que vincula funciones o archivos con las conversaciones que les dieron forma. Se instala mediante un script de shell o npm, y los hooks se activan y las conversaciones se importan solo después de un paso de configuración explícito.

De forma opcional, genera resúmenes narrativos de las conversaciones para crear informes consultables mediante la ejecución de Claude CLI; esta función se puede desactivar con una variable de entorno.

Funciones clave

  • 01Búsqueda semántica de conversaciones anteriores de Claude Code mediante embeddings locales
  • 02Un único binario de Rust con almacenamiento en SQLite e índice vectorial HNSW, sin servicios externos
  • 03Seis hooks del ciclo de vida que inyectan automáticamente contexto relevante del pasado
  • 0415 herramientas MCP para consultas por archivo, concepto, cronología y conversación
  • 05Grafo de código que vincula funciones y archivos con las conversaciones que les dieron forma
  • 06Configuración basada en el consentimiento: el registro MCP y los hooks se instalan solo al activarlos

Casos de uso

  • Recordar cómo se solucionó un error o cómo se diseñó un componente en una sesión anterior de Claude Code
  • Encontrar las conversaciones que dieron lugar al código actual de un archivo o una función
  • Mantener disponibles las decisiones de proyectos de larga duración a lo largo de numerosas sesiones

Inicio rápido

  1. 1

    Ejecuta el script oficial de instalación del README (descarga el binario y pide confirmación antes de activarlo).

  2. 2

    Instala mediante npm (solo descarga el binario; no lo activa).

    npm install -g claude-self-reflect
  3. 3

    Activa la configuración (registra el servidor MCP, instala los hooks e importa las conversaciones).

    csr-engine setup
  4. 4

    Reinicia Claude Code.

Antes de usarlo

  • Los binarios precompilados son compatibles con macOS Apple Silicon, Linux x86_64/WSL y Linux ARM64; en Intel Mac es necesario compilar desde el código fuente.
  • Las narrativas de IA son opcionales, pero usan tu suscripción de Claude mediante claude -p y consumen tokens.

En colecciones

Memoria a largo plazo para agentes de IAServidores MCP para Claude CodeHerramientas, skills y plugins para Claude CodeServidores MCPHerramientas de privacidad y local-firstBases de datos y herramientas SQL

Temas

#ai-memory#claude-code#mcp#semantic-search#vector-search#rust#sqlite#local-first#claude#claude-desktop

Preguntas frecuentes

¿Qué es claude-self-reflect?
Herramienta local en Rust que dota a Claude Code de memoria persistente de conversaciones anteriores mediante búsqueda semántica y se ofrece como servidor MCP. Claude Self-Reflect es una capa de memoria para Claude Code. Indexa transcripciones de conversaciones anteriores de ~/.claude/projects y permite buscarlas, para recuperar cuando sean relevantes soluciones, decisiones de diseño e historial de depuración de sesiones previas. Se distribuye como un único binario de Rust que almacena fragmentos, embeddings y el estado del enriquecimiento en SQLite, y utiliza un índice HNSW para la búsqueda vectorial con embeddings locales de FastEmbed. La búsqueda básica no requiere un servidor de base de datos, un contenedor ni una clave de API.
¿claude-self-reflect es gratuito? ¿Qué licencia tiene?
claude-self-reflect es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿claude-self-reflect sigue mantenido?
Mantenimiento activo. El último commit de claude-self-reflect fue el 2 nov 2026.
¿Para qué puedo usar claude-self-reflect?
Recordar cómo se solucionó un error o cómo se diseñó un componente en una sesión anterior de Claude Code Encontrar las conversaciones que dieron lugar al código actual de un archivo o una función Mantener disponibles las decisiones de proyectos de larga duración a lo largo de numerosas sesiones
¿Cómo se instala claude-self-reflect?
Ejecuta el script oficial de instalación del README (descarga el binario y pide confirmación antes de activarlo). Instala mediante npm (solo descarga el binario; no lo activa).: npm install -g claude-self-reflect Activa la configuración (registra el servidor MCP, instala los hooks e importa las conversaciones).: csr-engine setup Reinicia Claude Code.
¿Dónde consigo claude-self-reflect?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ramakay/claude-self-reflect

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados